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(54) A network portal system and methods 

(57) A network portal system includes a web-top 
manager and a universal content broker system. The 
web-top manager is configured to receive a content re- 
quest from a user device, where the content request in- 
cludes a content provider identifier The universal con- 
tent broker system is coupled to the web-top manager. 
The universal content broker system includes a plurality 
of content providers. Each content provider in the plu- 
rality of content providers is associated with a different 
content providier identifier Also, each content provider 
accesses content having a different raw data format. A 
universal content broker is coupled to the web-top man- 
ager and to the plurality of content providers. Upon the 
receipt of the content request from the web-top manag- 
er, the universal content broker passes the request to a 
content provider in the plurality of content providers that 
is associated with the content provider identifier 
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Description 

CHAPTER A 
5 BACKGROUND OF THE INVENTION 
Field of the Invention 

[0001] This Invention relates generally to network systems and in particular to network portal systems 

10 

Description of Related Art 

[0002] Laptop and notebook computers abound, virtually every enterprise in every business sector uses e-mail for 
Internal and external communications, mobile phones are commonplace, and many people carry personal digital as- 

15 sistants (PDAs) with wireless communication capability. Intemet cafes can be found in almost every city, airports rou- 
tinely have Intemet kiosks, and most hotel rooms come equipped with data communication facilities. 
[0003] With these developments come limitations and frustrations. Laptops and notebooks frequently require that 
special applications be installed. If work needs to be done when that particular machine is not available, the work must 
be postponed. In addition, there are employees without laptops who nonetheless need to access information and 

20 applications when they are away from the office. 

[0004] Data on laptops must be synchronized with data on the enterprise's central computers. Before employees 
can work on their laptops, they must be certain that they have the latest information, and that after they have finished, 
the centrally housed information must be updated. 

[0005] Functionality available from mobile phones and PDAs is typically limited to general infomiation services, such 

25 as stock quotes and airline schedules. 

[0006] Many enterprises have realized significant benefits from client/server technology but this typically entails the 
installation of specialized software on the client systems, thereby limiting access to only those devices with the spe- 
cialized software as well as placing a maintenance burden on the organization, which must propagate changes and 
updates to ail individual woricstations, laptop computers, etc. 

30 [0007] As organizations implemented individual applications, frequently in different languages, functionality and data 
often became fragmented. A growing amount of valuable information is available from web-based service providers. 
However, locating the information can be time-consuming, and the infomnation comes in as isolated pieces of data. 
[0008] As a result, people are frequently not able to do the wori< they need to do when they want to do it. The 
information would be more valuable if the infomnation were made available to corporate applications and merged with 

35 enterprise data. 

[0009] Competitive business pressures make this issue even more urgent. Not long ago, it was perfectly acceptable, 
for example, for a salesperson to return to a customer's office the following day with requested infomiation. Today, 
however, immediacy and convenience are the keywords; with the Intemet, people have become accustomed to ac- 
cessing data on demand and to taking action whenever they wish. Any work that has to be postponed because the 
40 salesperson could not access applications or data can mean lost opportunity 

[001 0] Enterprise portals are being developed to close the gap between what users would like to do and what tech- 
nological constraints permit them to do. While the rapid rate of recent technological innovation has been exciting, there 
are many attendant restrictions. 

[0011] Enterprise portals allow users to access a wide variety of applications, services, and data through a single 
45 entry point (the portal). Portal computing is a network solution that aims to make recent technological advances serve 
the way people actually work-or would like to wortc. Recognizing the adyantages of portal computing, several service 
providers have already embraced the concept, albeit In a limited sense, offering their customers a growing number of 
application services. Notable examples Include Yahool. Excite, and Lycos. Although these all started as search engines, 
they now offer such capabilities as e-mail, stock quotes, calendar facilities, etc. 
50 [0012] Quick to join the bandwagon, many suppliers have announced portal products. Some are not solutions, but 
rather tools that would allow companies to develop their own, severely limited portals. Some products provide the ability 
to access and consolidate different types of data from various sources for reporting purposes, but do nothing to support 
the inclusion of existing applications. Others may support a diversity of data as well as the ability to interface with 
existing applications (to varying degrees), but they place restrictions on the types of devices people can use to access 
55 the system. 

[0013] A further limitation of these portal products is the great number of different content and services available 
over a networic like the Intemet which in turn, has lead to an enormous variety of different communication standards, 
data formats and file formats, which are sometimes proprietary for the particular content and services. 
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[0014] As a consequence, services or content provided by some provider systems may be incompatible with services 
or content provided by other provider systems and thus have a **stove-pipe" nature as to their presence and operation 
on networks. In addition, there exist many different communication schemes for content or sennce. which communi- 
cation schemes again may be Incompatible and not universally accessible or supported by all client systems. Accord- 
5 Ingly, the existing portal products are limited to a subset of client systems and permit this subset of client systems to 
access at most a limited amount of content that is available. 

SUMMARY OF THE INVENTION 

10 [0015] It Is therefore the object of the Invention to allow an universal and integral use of different services by arbitrary 
client systems over a network. 

[0016] The object of the invention is solved by the features of the independent claims. 

[0017] According to one embodiment of the present invention, a network portal system allows the universal and 
integral use of different services by arbitrary client systems. The network portal system links, via a communication 
15 network, a plurality of content provider systems with a plurality of client systems. Each content provider system that 
offers content is associated with a content Identifier, which in one embodiment Is a URL scheme. The content is infor- 
mation that is transmittable over the communication network. 

[0018] In one embodiment, the network portal system includes a web-top manager. The web-top manager receives 
a content request from a client system. According to one enibodiment of the present invention, each content request 
20 includes a content Identifier of the content requested by the requesting client system. Optionally, the content request 
includes a client system identifier and/or a content type. Alternatively, a process on the network portal system may 
determine the client system Identifier and content types supported by the client device. 

[0019] The web-top manager In the network portal system communicates with a universal content broker system 
that also is in the network portal system. Upon receipt of a content request from the web-top manager, a universal 
25 content broker in the universal content broker system, using resources within the network portal system, selects a 
content provider system, which Is able to provide the requested content Next, the universal content broker accesses 
the selected content provider system, and issues a request that results in the perfomnance of the action specified in 
the request by the accessed provider system. 

[0020] If the request was to retrieve content, the content in a raw data format is passed to the wet>-top manager. The 
30 web-top manager renders the requested content into a page that can be displayed by the requesting client system and 
this page is returned to the requesting client system. Thus, the network portal system with its different aspects allows 
a client to get content from a provider system even if the client system and the provider system do not use the same 
communication protocol. 

[0021] Provider systems are associated with the URL schemes they implement A service or content Is obtained by 
35 passing a uniform resource indicator URL to a provider system. The provider system infers what the scheme is and 
therefore what provider system can create the content. Provider systems create content objects that implement defined 
network portal interfaces associated with content such that a client system can infer and or operate on: MIME type, 
child content, commands, properties, changes to state. 

[0022] In addition, new content may be created from existing content and stored to be retrieved later The new content 
40 may be related to the existing content. An example of which could be an address book that may only store content of 
type "folder^ and "address". 

[0023] In another embodiment of the present invention, the network portal system includes a web-top manager and 
a universal content broker system. The web-top manager Is configured to receive a content request from a user device, 
where the content request includes a content provider identifier 

45 [0024] The universal content broker system is coupled to the web-top manager The universal content broker system 
includes a plurality of content providers. Each content provider in the plurality of content providers Is associated with 
a different content provider Identifier Also, each content provider accesses content having a different raw data fomnat. 
A universal content broker is coupled to the wet>-top manager and to the plurality of content providers. Upon the receipt 
of the content request from the web-top manager, the universal content broker passes the request to a content provider 

50 in the plurality of content providers that is associated with the content provider identifier 

[0025] The web-top manager includes a plurality of remote applications; a web server; a main servlet executing on 
the web server, wherein the main servlet receives a user device content request; and a presentation and logic system 
coupled to the main servlet. The presentation and logic system is configured to receive raw data content in a plurality 
of different raw data formats from the universal content broker system. The presentation and logic system converts 

55 raw data content In^espective of the raw data fomnat, based upon characteristics of the user device, into a page dis- 
playable on the user device. 

[0026] In one embodiment, the presentation and logic system includes a plurality of templates. A first set of template 
sets is for a first type of user device page format A second set of template sets Is for a second type of user device 
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page format. A third set of template sets is for a third type of user device page format. In general, there Is a template 
set for each unique type of user device, which means that the user device cannot display a page created for another 
user device. 

[0027] In one embodiment, the first set of template sets includes a set of content format template sets wherein each 
5 content fomiat template set is for a different one of the plurality of different raw data fomnats. The set of content fomnat 
templates Include a set of device capability specific templates. 

[0028] Yet another embodiment of the presentation and logic system includes a plurality of adapter objects coupled 
to a plurality of provider objects. Each adapter object is associated with a different content provider identifier. The 
adapter object receives content from a content provider associated with the different content provider identifier and 

10 provides the content to the provider object associated with the different content provider identifier The provider object 
selects an appropriate template for the above-mentioned sets and causes information in the content received to be 
inserted in the template so that the page retumed to the user device includes the requested content. 
[0029] tn stilt yet another embodiment, the presentation and logic system includes a profiting service and a profiling 
service configuration file coupled to the profiling sennce. The profiling service configuration file includes a decision tree 

15 Wherein the decision tree performs actions. In one embodiment, decision tree is a XML decision tree. The actions 
performed by the decision tree include: an action based upon request parameters; an action based upon request 
header parameters; an action based upon user device properties; and an action based upon resource properties. 
[0030] This embodiment of the presentation and logic system also includes a plurality of screen templates. One 
screen template in the plurality of screen templates is a default screen template for a IHTML page. Another one screen 

20 template In the plurality of screen templates is a default screen template for a mobile telephone. Still another screen 
template In the plurality of screen templates is a default screen template for a personal digital assistant. 
[0031] One screen template in a plurality of the screen templates comprises a default screen template. The default 
screen template includes a header region having at least one placeholder and a body region having at least one 
placeholder. An action of the decision tree determines a component that is used for the at least one placeholder in the 

25 body region. The component provides information that Is taken from the raw data content. 

[0032] In another embodiment, a universal content broker system also includes a registry of content providers cou- 
pled to the universal content broker. The universal content broker selects the content provider from the registry based 
upon the content provider identifier. The universal content broker system also includes; at least one interface adapted 
to associate property values with content; at least one interface adapted to set a property value of content; at least 

30 one interface adapted to read a property value of content; an interface adapted to notify registered client s^tems when 
content of interest to the registered client systems Is processed by the universal content broker system; and an interface 
adapted to notify registered client systems when content of interest to the registered client systems is created by the 
universal content broker system. 

[0033] Still another embodiment of the universal content broker system includes a hierarchy content provider The 
35 hierarchy content provider generates a virtual hierarchy of content of the universal content broker system. 

[0034] Still yet another embodiment of the universal content broker system includes a configuration server. A con- 
figuration proxy Is coupled to the configuration server 

[0035] The configuration server further includes a first DOM tree that in turn includes user profiles and application 
profiles. Configuration proxy includes a second DOM tree that in turn Includes a subset of data in the first DOM tree. 

40 [0036] A client system is coupled to the network portal system. The client system includes a client universal content 
broker system. The client universal content broker system includes a synchronization component for synchronizing 
content of ihe client universal content broker system with content of the universal content broker system. 
[0037] In one embodiment of the present invention a computer program product comprising computer program code 
for a universal content broker service including at least one of. oraltematively any combination of a component interface; 

45 a content provider interface; a content provider manager interface; and a content identifier factory interface. 

[0038] In another embodiment, a computer program product comprising computer program code for a configuration 
and logic service includes a profiling service and a plurality of screen templates. 

[0039] A method for providing a plurality of content having different types and different protocols to a single user 
interface includes: 

50 

receiving a content request from a client system the content request comprising a content identifier, 

selecting a content provider associated with the content identifier from a plurality of content providers wherein 
each of the content providers provides access to content having a different raw data format; 

55 

retrieving the requested content from the selected content provider; 

using the retrieved requested content to generate a page displayable on the client system. 
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[0040] Hence, the inventive network portal system delivers the framework for 

Aggregation of existing network portal services so that they are presented for use from single access points. 

5 interfacing new and existing application systems and enabling them to be presented as network services. 

Coupling of separate network service provider systems to deliver integrated functional interactions between these 
previously standalone network services systems. 

10 Allowing the construction of new network services which are constructed by joining and reconstituting existing 

network services. 

Unifying the Interfacing to the services, including the user interfaces (Ul) and the service provider interfaces (SPI). 
By unification of the Ul framework, users can experience a contiguous "surfing" metaphor for interactions. Unifi- 
es cation of the SPI enhances extensibility and the construction of more sophisticated services with the existing serv- 
ices available as common building blocks. 

Creating a highly scalable networi^ service portal infrastructure, using distributed service portal servers - effectively 
a web of networi^ portal systems. 

20 

[0041] In one embodiment, the inventive network portal system Is used for providing the interfacing and aggregation 
of services via a network, and acts as a content switch leading these streams to the appropriate service filters of the 
networtc portal system, e.g., Office productivity, file format conversion, user interface management, etc. The inventive 
network portal system is a framework designed to unify the access, modification and creation of structured information. 

25 [0042] Services or content such as file systems, databases, mail and news in addition to files, records, mail, and 
news messages may be represented abstractly using the inventive networtc portal system in this embodiment. A hier- 
archy of content may be represented according to the concepts of parent-, peer-, child-relationships. Further, content 
may be considered as fc>eing tasks, which in tum may t>e further split into higher forms of properties, and commands. 
Values of properties may be set and obtained. Content may have a set of commands that operate on it. 

30 [0043] The communication network may be of any type suitable for communication between computer systems, 
wired, partially or totally wireless. The computer systems may be of any type of processing environments, and of any 
size. They may be embedded into other systems. 

[0044] According to another embodiment, a networtc portal system is provided, which serves for linking, via a com- 
munication rietworic, a plurality of provider systems with a plurality of client systems, each said provider system offering 
35 content according to a predetermined communication scheme of a plurality of different communication schemes, said 
content being information which is transmittable over said networtc, each said client system supporting a predetermined 
communication scheme of said plurality of different communication schemes, said network portal system comprising: 

a) webtop means for receiving a content request from a client system, said request comprising a content indicator 
40 being indicative of the content, and an indicator of the requesting client system, said client system indicator spec- 
ifying the communication scheme supported by said Calient system, 

b) universal content broker means for selecting a provider system which is able to provide said requested content, 
"fs for accessing said selected provider system, and 

for retrieving said requested content from said accessed provider system, 

c) said webtop means being further adapted for rendering the retrieved cx>ntent to said requesting client system 
50 according to the communication scheme of said requesting client system. 

[0045] The invention comprises also a methcxj for linking, via a communication network, a plurality of provider sys- 
tems with a plurality of client systems, each said provider system offering content according to a predetermined com- 
munication scheme of a plurality of different communication schemes, said content being information which is trans- 
55 mittable over said networtc, each said client system supporting a predetermined communication scheme of said plurality 
of different communication schemes, said method comprising the following steps: 

a) receiving a content request from a client system, said request comprising a content indk:ator being indicative 
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of the content and an indicator of the requesting client system, said client system indicator sp»ecifyjng the com- 
munication scheme supported by said client system, 

b) selecting a provider system which is able to provide said requested content, 

5 

c) accessing said selected provider system, 

d) retrieving said requested content from said accessed provider system. 

10 e) rendering the retrieved content to said requesting client system according to the communication scheme of said 

requesting client system. 

[0046] Thus, the network portal concept according to the invention with its different aspects allows a client to get 
content from a provider system even if the client system and the provider system may not use the same communication 

^5 scheme. In the network portal system, the content to be rendered to the client system is converted accordingly. Provider 
systems are associated with what URL schemes they implement. A service or content Is obtained by passing a unifomi 
resource indicator URL to a provider system. The provider system infers what the scheme is and therefore what provider 
system can create the content. Provider systems will create content objects that implement defined network portal 
interfaces associated with content such that a client system can infer and or operate on: MIME type, child content, 

20 commands, properties, changes to state. 

[0047] In addition, new content may be created from existing content and stored so as to be retrieved later The new 
content may be related to the existing content. An example of which could be an address book that may only store 
content of type "folder' and "address**. 

[0048] Accordingly, the inventive network portal system delivers the frameworic for 

25 

Aggregation of existing networic portal services so that they are presented for use from single access points. 

Interfacing new and existing application systems and enabling them to be presented as network services. 

30 . Coupling of separate networic service provider systems to deliver integrated functional interactions between these 
previously standalone network services systems. 

Allowing the construction of new network services which are the constructed by joining and reconstituting existing 
network services. 

35 

Unifying the interfacing to the services, including the user interfaces (Ul) and the service provider interfaces (SPI). 
By unification of the Ul framework, users can experience a contiguous "surfing" metaphor for interactions. Unifi- 
cation of the SPI enhances extensibility and the construction of more sophisticated services with the existing serv- 
ices available as common building blocks. 

40 

Creating highly scalable networic service portal infrastructure, using distributed sen/ice portal servers - effectively 
a web of networic portal systems. 

[0049] The inventive networic portal system is used for providing the interfacing and aggregation of services via a 
45 network, and acts as a content switch leading these streams to the appropriate service filters of the networic portal 
system, e.g. Office prcxJuctivity, file format conversion, user interface management, etc. The inventive networic portal 
system is a framework designed to unify the access, modification and creation of structured information. 
[0050] Services or content such as file systems, databases, mail and news in addition to files, records, mail and 
news messages may be represented abstractly using the inventive network portal system. 
50 [0051] A hierarchy of content may be represented according to the concepts of parent-, peer-, child-relationships. 
[0052] Further, content may be considered as being tasks, which in tum may be further split into higher forms of 
properties, and commands. Values of properties may be set and obtained. Content may have a set of commands that 
operate on it. 

[0053] The communication networic may be of any type suitable for communication between computer systems, 
55 wired, partially or totally wireless. The computer systems may be of any type of processing environments, and of any 
size. They may be embedded into other systems. 

[0054] The invention can be implemented by a computer system comprising computer program code or application 
code. 
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[00551 Computer program code or application code may be embodied in any form of a computer program product. 
A computer program product comprises a medium configured to store or transport computer-readable code, or in which 
computer-readable code may be embedded. Some examples of computer program products are CD-ROM disks, ROM 
cards, magnetic disks or tapes, sendee on a network, and carrier waves. The computer program product may also 
comprise signals which do not use carrier waves, such as digital signals transmitted over a network. The computer 
program product may then be implemented as any transmission link, such as a connection to the intemet, or any LAN, 
WAN. telephone network, or the like. 

BRIEF DESCRIPTION OF THE DRAWINGS 

[0056] 

Fig. 1A is a conceptual diagram of a network portal system that includes a web top manager and a 

universal content broker system according to one embodiment of the present invention. 

Fig. IB is a user device with a display screen that shows portlet accessible by a user according to one 

embodiment of the present invention. 

Figs. 2A to 2C are prior art screen displays on a display screen of a user device. 

Fig. 2D is a display of the hierarchical interface created by a hierarchical content provider according 

to one embodiment of the present invention. 

Fig. 3A is a more detailed diagram of the network portal system according to one embodiment of the 

present invention. 

Fig. 3B is a diagram that illustrates a server universal content broker system and a client universal 

content broker system according to one embodiment of the present invention. 

Fig. 4 is a process flow diagram for processes according to one embodiment of the present invention. 

Fig. 5 is a more detailed illustration of presentation and logic service according to one embodiment 

of the present invention. 

Fig. 6 is an illustration of the illustrative provider factories and templates for the presentation and logic 

service according to one embodiment of the present invention. 

Fig. 7 is an illustration of data rendering for a user device in the presentation and logic service ac- 

cording to one embodiment of the present invention. 

Fig. 8 is a more detailed illustration of presentation and logic service according to another embodi- 

ment of the present invention. 

Fig. 9 is an illustrative of a default template used to generate a thin client according to another em- 

bodiment of the present invention. 

Fig. 10 is an example of a screen display generated using the template of Fig. 9 according to another 

embodiment of the present invention. 

Fig. 11 is an actual example of a portion of a default template according to another embodiment of the 

present invention. 

Figs. 12A to 12C are pseudo code for a decision tree of the profiling service according to another embodiment 
of the present invention. 

Figs. 13A and 13B are portions of an actual decision tree used in generating the display of Fig. 10 according to 
another embodiment of the present invention. 
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Fig. 14 is an illustration of the process In completing a display template according to another embod- 

iment of the present Invention. 

Fig. 15 is a detailed block diagram of a configuration server according to another embodiment of the 

5 present Invention. 

Figs. 1 6A and 16B are two examples of DOM trees found in the configuration server according to another embod- 
iment of the present Invention. 

10 Fig. 17 is an example of a merged configuration tree of a user according to another embodiment of 

the present invention. 

Fig. 18 is an example of the file structure used to store the data in Fig. 16B according to another 

embodiment of the present invention. 

15 

Figs. 1 9A to 1 9E are examples of envelopes used by the configuration server according to another emt>odiment 
of the present invention. 

Fjg. 20 is a sequence diagram that illustrates the asynchronous processing capability of the interfaces 

20 according to another embodiment of the present invention. 

Fig. 21 is an illustration of the processes implemented by the universal content broker according to 

another embodiment of the present invention. 

25 Fig, 22 is an illustration of the components of the hierarchy service according to another embodiment 

of the present invention. 

Fig. 23 gives a general overview of a network in which a network portal system is operated; 

30 Fig. 24 illustrates an embodiment of the inventive network portal system in greater detail; 

Fig. 25 to 27 illustrate operations of the universal content broker; 

Fig. 28 illustrates the method for linking provider systems with client systems by using the network 

35 portal system according to the invention; 

Fig.- 29 and 30 illustrate linking a client mobile telephone system to a network portal system; 

Fig. 31 illustrates the administration procedure for making a client system ready for login; 

40 

Fig. 32 illustrates accessing content by a client computer running a browser; and 

Fig. 33 illustrates the conversion of content. 

45 Fig. 34 shows a schematic representation of an example for an individual representation of data; 

Fig. 35 shows a schematic representation of the screen print of a user device; 

Fig. 36 shows a flow chart for obtaining the presentation requirements of a user device; 

50 

Fig. 37 illustrates a flow chart showing the steps to be carried out by a method for the individual rep- 
resentation of data; 

Fig. 38 illustrates a flow chart showing the operation of a method for an individual representation of 

55 data; and 

Fig. 39 shows a schematic representation of the portlet manager. 
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[0057] In the drawings 1 to 39 of CHAPTER A and the following detailed description of CHAPTER A, elements with 
the same reference numeral are the same or similar elements. Also, the first digit of a three digit reference numeral 
and ttie first two digits of four digit reference numeral indicates the first drawing in which that element appeared. 
[0058] In the Detailed Description, the headings are for convenience only and are not to be interpreted as limiting 
5 any element of the invention to the disclosure under a particular heading. Each emkKxjiment of each element is deter- 
mined by the entirety of this disclosure. Also, italics are used for convenience only, i.e., an italicized word, and the 
same word but not in italics are in fact the same thing. 

DETAILED DESCRIPTION 

10 

[0059] According to one embodiment of the present invention, a network portal system 1 00 solves the prior art portal 
limitations by giving users access from whatever device is available at the time, through a single system entry point, 
i.e., "a portal," to a complete complement of applications, sendees, and data. As explained more completely below, 
network portal system 100 frees a user from time and location constraints when accessing the complete complement 

15 of applications, services, and data. 

[0060] A user can access applications and data on network portal system 100 from almost any available device, e. 
g., any one of portable computer 102A, a mobile telephone 1 02B, a workstation 102C, a home personal computer (PC) 
102D, a personal digital assistant 102E, or an Internet cafe machine 102F. No longer is a user limited to using either 
workstations and/or portable computers with specialized software installed, or to using any particular Internet Service 

20 Provider 

[0061 ] Moreover, network portal system 1 00 provides the user with comprehensive functionality. The user's full range 
of applications is always available to the user In addition, enterprises can easily incorporate existing applications into 
network portal system 100. Also, the user can access multiple data sources via network portal system 100. Different 
types and formats of data, from different applications, can all be accessed and processed within a single user interface. 
25 Further, data from extemal sources, such as stock quotes from wet>-based service providers, can be accessed using 
the same single user interface. 

[0062] For example, a user on a vacation overseas suddenly realizes that the presentation her boss is going to 
deliver the next moming contains a critical en-or The user drops by an Internet cafe and from any machine 102F at 
the cafe accesses the presentation via network portal system 100. and makes the necessary corrections using appli- 
30 cations written, for example, in a scripting language and/or the C++ programming language even though only a browser 
is available on machine 102F. 

[0063] In another scenario, the user is having dinner at a friend's house, and gets an urgent call saying that a report 
that can be assessed via network portal system 100 must be revised tiiat evening. The revisions will not require much 
woric. but the trip to tiie office and back is a very unwelcome prospect. Using the friend's PC 102D and the friend's 

35 Internet service provider, ttie user works on the report without leaving his friend's home. 

[0064] Another user is expecting an important document, but the user has a business appointment outside the office. 
The document arrives by e-mail while the user is in transit. Using a PDA 102E while on the ti-ain, the user accesses 
the e-mail using network portal system 1 00. reviews the document, and then re-directs the document to tiie fax machine 
at the site to which the user is going. 

40 [0065] A customer would like to meet with a user tomon^ow. The user thinks he will be available, but the user doesn't 
know whether anyone scheduled the time while the user was away from the office, and now the office is closed. Using 
a mobile telephone 102B, the user accesses his up-to-the-minute calendar via network portal system 100 and sched- 
ules the appointment. 

[0066] Hence, according to one embodiment of the present invention, networic portal system 100 is a comprehensive 
^5 client/server offering that enables users to access their applications, data, and services from almost any device any- 
where. The applications and data are stored on network portal system 100 and are accessed using a web-top manager 
111 in combination with a universal content broker system 112 that includes universal content broker 113. In one em- 
bodiment, wet>-top manager 111 and universal content broker system 112 are designed as a distributed system that 
can be spread over multiple host machines, and can run on platforms utilizing any one of the operating systems Solaris, 
50 Windows NT/Windows 2000 (server version), or Linux In one embodiment, using a web browser and an Internet con- 
nection on any JAVA-enabled system, the user simply logs on to a web server in web-top manager 111, and proceeds 
as though everything were locally resident on his/her machine. (JAVA is a trademark of Sun Microsystems, Inc. of Palo, 
Alto, CA.) While execution actually takes place on the web server, this fact is transparent to the user. Similariy, local 
services available on a client system, including devices like printers and local storage, can be utilized by web sen^er- 
55 based components in a transparent manner. 

[0067] In addition to using JAVA-enabled browsers, users can access applications and data from Wireless Application 
Protocol (WAP) devices, which include mobile phone 102B, or from other hand-held devices such as PDA 102E. Be- 
cause of tiie limited capabilities of devices 1028 and 102E, functionality is not as extensive as from a system that can 



9 



EP 1 126 681 A2 



run a full browser. Accordingly, In one embodiment, users are able to view their mail and data, but users don't have 
full editing capabilities In this embodiment. However, users can use mobile phones and PDAs to manage their data 
and the users can direct the movement of infomnation to other devices. 

[0068] In one embodiment, web-top manager 1 1 1 includes a plurality of remote applications, such as office applica- 

5 tions that include, for example, a word processing application, a spreadsheet application, a database application, a 
graphics and drawing application, an e-mail application, a contacts manager application, a schedule application, and 
a presentation application. One office application package, suitable for use with this embodiment of the present inven- 
tion, is the STAROFFICE Application Suite available from Sun Microsystems. Inc., 901 San Antonio Road, Palo Alto. 
CA. (STAROFFICE is a trademark of Sun Microsystems, Inc.) 

10 [0069] As explained more completely below, the user accesses and runs a user selected remote application using 
only a thin-client on the user's device with a lightweight component Installed. To the user, it appears as if the remote 
application is installed on the user device. However, typically, both the data being processed and the remote application 
are on network portal system 100. In addition, network portal system 100 allows users to incorporate their own appli- 
cations and data seamlessly, as well as to give the users access to information from extemal service providers. Network 

15 portal system 100 can be a user's sole entry into the world of information. 

[0070] • In one embodiment, access to extemal service providers is provided through portlets, where each portlet 
accessible by a user is represented on the display of the user device by an icon or perhaps a text name. For example, 
in Figure 1 B, a display 1 50 of user device 1 02A includes icons 1 20 to 1 22. each of which is associated with a different 
portlet. Through use of a dynamic content channel, e.g., a portlet. a highly customizable content page may be produced 

20 for any individual client system. 

[0071] In one embodiment, when a portlet icon is selected on a user device, the content associated with the portlet 
is retrieved by network portal system 100 and automatically transformed by network portal system 100 into data that 
can be displayed by that user device. Thus, a particular user device is not limited to accessing content in a format 
identical to that associated with the user interface in use on the user device. Consequently, the user's ability to access 

25 a wide variety of content sources independent of the characteristics of the particular user device is further enhanced 
with the portlets of this invention. 

[0072] An individual user can personalize the user device, and hence network portal system 1 00, by specifying which 
service providers from among the ones the organization has made available via portlets, the user wants to use. To put 
it another. way, the user chooses which portlets the users wishes to be included on the desktop as illustrated in Fig. 
30 IB. Hence, network portal system 1 00 eliminates prior art limitations on a single user system on a network accessing 
content on any desired provider system that is coupled to the network. 

[0073] In one embodiment, the functionality described above is provided using a browser executing on a client device 
102i (See Fig. 1A). e.g., any one of devices 102A, 102C, 102D and 102F The browser communicates with web-top 
manager 111 viae network, e.g., enterprise network 103, Internet 106. or a combination of the two 103/106. A user of 
35 client device 102i causes the browser to transmit a request via the network to web-top manager 111. Typically, the 
request includes the type of document or service requested, the type of client device 102i that is making the request, 
the type of the browser executing on client device 1 02i, and a protocol that is typically part of a uniform resource locator 
(URL] included in the request. 

[0074] Upon receipt of the request, web-top manager 111 processes the request. If the request is for content that is 
^0 provided by one of universal content providers 101 A to 101 C that are registered with universal content broker 113, 
web-top manager 111 issues a call to universal content broker 113. If the content is available through a portlet, the 
request is passed to a portlet manager, which in one embodiment, as described more completely below, is a servlet 
executing on web-top manager 111. 

[0075] In response to a call from wefc>-top manager 111, universal content broker 1 1 3 returns a handle to the requested 
^5 content to web-top manager 111. Web-top manager uses the handle in retrieving the content. However, before the 
content is retumed to user device 1021, in one embodiment, the content is converted to a page or pages that can be 
displayed and/or processed by the thin-client on the user device. 

[0076] As explained more completely below, web-top manager 111 includes a user interface, which is defined via 
different XML, HTML or WML templates and/or stylesheets. Web-top manager 111 selects a template, or stylesheet 
so using the infomnation transmitted in the request from client device 102i. The template, or stylesheet selected by web- 
top manager 111 is used to present content in the form required by client device 102i. 

[0077] Hence, upon retrieving the requested content using the handle provided by UCB 113, web-top manager 111 
loads, for example, a template and fills in all user specific content in the template using the retrieved content. The 
completed template is transmitted to client device 102i for display. Alternatively, web-top manager 111 retrieves a 
55 stylesheet and uses the stylesheet to transform the content into a format that can be displayed on client device 1021. 
[0078] This example assumed that the information in the retrieved content was in a format such that the information 
could be extracted and placed in the template or could by transfomied using a stylesheet. In another embodiment, the 
retrieved content is processed by a dynamic data conversion service. The dynamic data conversion service generates 
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a dynamic data filter that includes a chain of partial filter adapter components. The dynamic filter converts the original 
retrieved content from a first format into a second format such that the information can be extracted and placed In the 
template or transformed using a stylesheet. The generation of dynamic data filters facilitates processing a broad range 
of content with differing formats by networic portal system 100. 
5 [0 079] The above example assumed that the client request was for content provided by a registered content provider 
or for content available via a portlet. Alternatively, the request could be to launch a remote application in web-top 
manager 111. In response to this request, web-top manager 111 prepares a template that includes, for example, an 
HTML page that includes JAVA Bean and returns the page to the browser. 

[0080] Upon execution of the JAVA Bean, the user has full access to the capabilities of the remote application that 
10 Is executing on network portal system 100 just as if the complete application were executing on client device 1021. If 
the user requests that the remote application process specific content, e.g., a text document, or perhaps a spreadsheet, 
the request is sent by the application to universal content broker 113 that functions as described above. 
[0081] Alternatively, the user may direct the remote application to access a spreadsheet calculator. Recall that as 
described above, network portal system 100 may be implemented in a distributed environment, in which the text 
15 processing application executes on one computer under a first operating system and the spreadsheet application 
executes on another computer under a second operating system. Alternatively, both applications may execute on the 
same computer, but the text processing application is written in one programming language and the spreadsheet ap- 
plication is written In a different programming language. 

[0082] In either of these situations, the text processing application is executing within a first execution environment, 
20 and in response to the user request the text processing application issues a call to the spreadsheet calculator of the 
spreadsheet application that is executing within a second execution environment that is different from the first execution 
environment. 

[0083] As used herein, an execution environment contains all objects, which have the same binary specification and 
which lie in the same process address space. The execution environment is specific for a computer programming 

25 language and for a compiler for that computer programming language. According to one embodiment of the present 
Invention, the call from the text processing application is directed to a proxy in a bridge that converts the original call 
to a call to the desired service in the second execution environment. The proxy dispatches the converted call to the 
desired service in the second execution environment. Upon execution of the converted call in the second execution 
environment, the results are returned to tiie proxy in a bridge that in tum converts the results from ttie second execution 

30 environment to the first execution environment. The converted results are returned to the text processing application 
for use, A more detailed description of a bridge and proxy Is provided in CHAPTER B t>eiow. 
[0084] Hence, trarisparentiy to. the user, the user has accessed functionality distributed within networic portal system 
100 using only what appears to the user as a single application executing on client device 1021. The ability to trans- 
parentiy access applications and services in different execution environments greatiy increases the services and func- 

35 tionality that can be provided to a wide variety of client devices. 

[0085] Thus, network portal system 100. in one embodiment, not only includes a dynamic data format conversion 
capability for content, but also a dynamic dispatch functionality for accessing sendees in different execution environ- 
ments. These functionalities are optional, but when included in network portal system 100, the functionalities ti-anspar- 
ently expand the services and capabilities available to client device 102i that has only a browser installed. 

40 [0086] Another service provided by network portal system 100 is a hierarchy service, which in one embodiment is 
one of the universal content providers accessible via universal content broker 113. In the prior art as illustrated in 
Figures 2A, 28, to 2C, each time the user wanted to access e-mail message, HTTP links, or a stored file, the user had 
to access a different program element that in tum generated a display associated witii that program element, e.g.. 
displays 2dOA to 200C, However, when the user accesses an explorer within the browser on client device 102i, the 

45 hierarchy service in network portal system 100 returns a page that results in a virhjal hierarchy 210 that is displayed 
as lllustiBted in Figure 2D. 

[0 087] The hierarchy service organizes the user's data in an abstract manner whether the data is the user's directory, 
mail accounts, or bookmarks. As illustrated in Figure 2D, the hierarchy service orders all user content in a virtual 
hierarchy 210, which is represented in the user interface on client device 1021. Virtual hierarchy 210 is browse-able 

50 and customizable, gives ttie user a homogenous view of ttie entire user's content on network portal system 100. In 
this embodiment, virtual hierarchy 210 includes a root node 230 and three other nodes 231 to 233. Initially, only root 
node 230 may be displayed and ttien when the user selects root node 230. nodes 231 to 233 are displayed. If the user 
then selects one of nodes 231 to 233. the user is presented with tiie hierarchy indicated by ttie broken arrow. 
[0088] In addition, virtual nodes generated by the hierarchy service act as UCB content nodes. So ttie resulting 

55 hierarchy, sometimes referred to as a content tt-ee, consisting of ttie virtual nodes and protocol specific nodes, as 
illustrated in Figure 2D, can be processed in a transparent manner. This means, that a generic explorer or all kind of 
viewers can access the whole content ti'ee without special knowledge about the underiying protocols or implementation 
details of the specific providers associated with the various virtual nodes. 
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[0089] Figure 3A is a high-level block diagram of one embodiment of network portal system 100, which provides 
ofHce productivity services. Network portal system 100 is highly independent of client systems 102i. where t is A. C. D 
and F in Figure 1 , and 102j where j Is B in Figure 1 , which are used to access services and/or content using network 
portal system 100. Support of several client devices with very different hardware and software capabilities mandates 
5 that the overall architecture and the core components of network portal system 100 are flexible enough to minimize 
the effort of integrating support for new client devices. 

[0090] As used herein, content provider systems, servers, client systems, networks and similar temns are utilized 
with respect to computer systems and interconnections of both such systems and individual units, and may include 
both the hardware and software typically utilized in such systems. In this context, the term content denotes any infor- 
10 mation, which may be of any kind in any physical or logical fomiat, which can be transmitted over a communication 
network. In particular, content may be any information that is stored in the fomi of electronic files, typically residing on 
a server, or content may be generated by execution of a particular application program. 

[0091 ] Communication standards, i.e. , protocols, which define the way of communication between two systems are 
used herein, in one embodiment, as content provider identifiers. An example, of a content provider identifier is a URL 

15 scheme that is described more completely below. A MIME type is an example of a definition of a type of content. In 
general, the content type determines the raw data format of the content. As explained more completely below, the 
content identifier is used to select a content provider that supplies, creates, or acts on content having a raw data format. 
[0092] Network portal system 100, according to the embodiment illustrated in Figure 3A, is divided into three tiers, 
e.g., a client tier 301, a middle tier 302, and an information system tier 303 that in turn are each divided into several 

20 subsystems. In this embodiment, client tier 301 includes a computer system 102i and a wireless application protocol 
(WAP) device 102j. Middle tier 302 is web-top manager 111. Information system tier 303 includes universal content 
broker system 112 that in tum includes a configuration sender 336 with associated database(s) 337, and universal 
content broker 113 that utilizes a plurality of universal content providers 331 and universal content broker (UCB) content 
332. In this embodiment, a hierarchy service 335 is one of universal content provider 331 and so is sometimes called 

25 hierarchy content provider 335. 

CLIENT TIER OVERVIEW 

[0093] In general, all hardware and software resources, which reside on users' devices, are part of client tier 301 . 
30 These resources may vary from a mobile phone 1 028 with WAP support, to an intemet kiosk 1 02 F with a HTM L browser, 
to a desktop PC 102D with an installed word processor and locally stored documents. In Figure 3A, the subsystems 
illustrated within client devices 102i and 102j are those that are typically used to interface with networic portal system 
100. 

[0094] Client device 1 02i, in one embodiment, includes a browser 304 that utilizes the HyperText Maricup Language 
35 (HTML) and a JAVA Virtual Machine (VM) 308 and executes JAVA scripts 309. Optionally, client device 1 02i can include 
one or more applications 305. As explained more completely below, one of the novel features of this invention is that 
a user can access, via browser 304, an application in remote applications 31 0 or any other service provided by network 
portal system 100. 

[0095] Any components needed to interface with the remote application and/or sen^ice are downloaded dynamically 
40 to client device 102i, when the components are needed. The complexity of tiiese downloaded components can differ 
extremely depending on the capabilities of client device 1021 and the requirements of the remote application and/or 
requested service. The download component can be a simple WML page, a set of HTML pages, which interact by 
JAVA script calls, or a complex JAVA applet. In another embodiment, a virtual class library for the particular user device, 
or perhaps a complete application may be downloaded. 
45 [0096] Herein, a thin client is a simple HTML page. To the extent possible, in one embodiment, networi^ portal system 
100 receives input requests and generates output responses using a thin client, because this minimize processing 
requirements on the client and minimizes tiie data quantity transferred over the network. 

[0097] Herein, the use of the JAVA programming language, JAVA scripts, and HTML are illusti-ative only and are not 
intended to limit the invention to the specific embodiments described. In view of this disclosure, equivalent functionality 
50 can be generated using any desired programming language, for example, tiie C programming language, or the C++ 
programming language can be used to develop browser add-ins. In particular, it is anticipated that the extensible markup 
language (XML) will supplement or replace HTML. 

[0098] WAP client device 1 02j includes a wireless markup language engine 306 tiiat executes wireless mari^up lan- 
guage scripts 307. WAP client device 102j communicates with a gateway 105 tiiat interfaces device 102j with web-top 
55 manager 111 in one embodiment. 
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MIDDLE TIER OVERVIEW 

[0099] As indicated above, in the embodiment of Figure 3A, middle tier 302 is web-top manager 111. Wethtop man- 
ager 111 Includes a web server 320. Web sen/er 320 includes a desktop servlet 322 coupled to a presentation and 
5 logic system 323 that provides a presentation and logic service, and optionally, a portlet manager 321 that interacts 
with a plurality of portlets 324 that in turn are each a servlet. The number of portlets included in web server 320 is 
optional and can vary from zero to any desired number Herein, reference numeral 323 is used for both presentation 
and logic system and the presentation and logic service for convenience. 

[0100] An important aspect in building a flexible, extendable and robust network portal system 1 00 is to bring in one 
10 or more abstraction layers between client tier 301 and information system tier 303 to reduce dependencies of core 
components in information system tier 303 to specialized front ends. This abstraction, in general, is done by presen- 
tation and logic service 323 in middle tier 302. As explained more completely below, presentation and logic service 
323 provides functionality in an application oriented way and hides implementation details of information system tier 
303. 

15 [0101] In the following description, two alterative embodiments of presentation and logic service 323 are described. 
[0102] A first embodiment of presentation and logic service 323 uses a plurality of providers and adapters. The 
adapter fomns a link with universal content broker 113 and universal content broker content 332 to retrieve data, and 
an adapter extracts information from the data and builds a page that can be returned for display to the user device. 
[01 03] A second embodiment of presentation and logic service 323 uses controller servlets, JAVA beans as models, 

20 and JAVASERVER PAGES objects as views. As explained more completely below, in this embodiment a JAVA bean 
forms a connection with universal content broker 113 to retrieve data. A servlet extracts the desired information from 
the data and inserts the information in a JAVASERVER PAGE object that in tum is used to generate a page that can 
be retumed for display on user device 1 02i or 102j. 

[01 04] A second task of middle tier 302 is to provide access points for all kinds of clients in client tier 301 . to manage 
25 user sessions for clients in client tier 301, and to provide specialized functionality to different kinds of clients in client 
tier 301. As explained more completely below, this specialized functionality is provided by middle tier 302 (i) supplying 
dynamically generated pages that can be displayed on the user device, e.g., HTMLVWMLTXML pages, (ii) linking re- 
quests from components in client tier 301 to actions on data objects, or (ill) hosting one of a plurality of remote appli- 
cations 310, which are executed on a server machine for a client in client tier 301, but the user interface for the appli- 
30 cation is displayed on client device 102i. 

INFORMATION SYSTEM TIER OVERVIEW 

[01 05] As indicated above, the third tier, information system tier 303, includes configuration server 336 in universal 
35 content broker system 112. Information system tier 303 also includes universal content broker 1 1 3 that utilizes universal 

content providers 331 including hierarchy content provider 335 and universal content broker content 332. 

[01 06] In gisneral, all types of data - users' documents and configuration data - are stored and managed in information 

system tier 303, which is a server-side tier. Infomnation system tier 303 is the users' informational backbone, which, in 

the prior art, was typically housed in various databases in traditional legacy system architecture. (The users here are 
40 the clients in client tier 301 that were referred to above.) Network portal system 100 consolidates all resources under 

a single content manager, e.g., universal content broker 113, which allows a wide variety of data types to be accessed 

via a unified interface. 

[01 07] As described above, more than one data source can be used by or connected to network portal system 1 00. 
This means that data can be stored in local file system 544 (See Fig. 5), on an HTTP server 543, on a FTP server (not 
45 shown), in an e-mail account on I MAP server 542, or on a NFS server (not shown). One task of universal content 
broker 113 is to standardize the access to different data sources. 

[01 08] As explained more completely below, universal content broker 113 provides a range of functions for querying, 
modifying and creating data content. The use of different data sources is transparent for a portal user, i.e., the user of 
any user device coupled to network portal system 1 00. To facilitate the use of different data sources, hierarchy content 

50 provider 335 organizes the different sources in form of a hierarchical structure. For example, see Figure 2D. A user 
can classify the data sources by using user-defined folders and then browse through the content using an explorer. 
With the explorer and the hierarchical presentation of all the user's information available through universal content 
broker 113, the user does not have to think about which protocol has been used or what the type is of the particular 
data in accessing the data. As indicated above, data is accessed by going through a standardized interface that includes 

55 the explorer capability. 

[0109] Universal content broker 113 functions, in one embodiment, as a framework containing a range of elements 
and services for use with different data sources. Specifically, universal content broker 113 administers a plurality of 
universal content providers 331. Each universal content provider encapsulates the details of the different protocols 
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and data sources available through that provider. In one embodiment a set of default universal contisnt providers 331 
allows access through FILE, HTTP. FTP, IMAP, P0P3 and SMTP protocols. A portal operator can implement additional 
content providers so that in-house information services can be integrated into network portal system 100. For example, 
this could be a connection to a SAP™ system. 

5 [0110] The data content in UCB content 332 is encapsulated in content objects. The content objects implement, 
among other things, an interface for querying general information, as described more completely below. The interface 
can be used to call up different properties such as MIME type, URL, etc. Furthermore, each content object provides a 
series of commands for accessing the actual data by implementing other interfaces. The commands available in each 
individual content object depend on the data type. Commands such as an open command can be used in almost all 

10 content types, whereas a createFolder command would have little use in a pure text object. 

[0111] In many cases, applications and components of networi< portal system 100 use common data. If one appli- 
cation modifies the properties of content in a common file, all the components using this data should be informed of 
the changes made. For this reason, content objects can register various listeners to the content object on content 
listeners registry 340. The listeners then inform the different applications when properties have been modified. 

15 [01 12J As described above, content objects can contain different kinds of data. For example, a content object can 
encapsulate a file, an e-mail, a basic HTML page or a system folder. To facilitate handling the various content types 
in a standard way, each content object, sometimes called content, implements a standard set of Interfaces. These 
interfaces are described in detail below, but a brief summary of their function is given here. 
[0113] The interfaces include functions for calling content type and any commands that can be run on the content. 

20 [0114] Typical examples are commands such as "open" or "delete". A developer can define further commands de- 
pending on the content type. For exarriple, an "update" command can be used on a POP3 inbox. There is an additional 
function available for terminating a command. 

[0115] The interfaces also provide functionality to register different listeners that pass on alterations made to data 
to interested applications in the form of events. This type of message can result from such events as deletion or simply 
25 by changing content properties. If the content object is a folder, additional events can be sent when new sub-content 
has been inserted or removed. 

[0116] Each content object has a range of properties that can be read and re-set by an application. In one embodi- 
ment, content has to have certain properties, including title, MIME type and an id, for example. Furthemiore. optional 
properties can be set if required. This could cover such information as the date the content was created or modified 

30 or the saving of passwords. 

[01 17J Content node hierarchies can be built for content objects such as an IMAP account or a file system as illus- 
trated in Figure 2D. In these situations, a parent-child relationship exists between the different content objects. To 
enable access not only to parent nodes but also to child nodes, the content objects implement additional interfaces 
that also allows new nodes to be created and inserted. 

35 [0118] Universal content providers 331 make access possible to the different data sources in UCB content 332. Each 
content provider implements an interface, which facilitates access to data through a Uniform Resource Identifier (URI). 
This has the following structure (see RFC 2396): 

<scheme>://<authority><path>?<query> 

[01 19] The stmcture describes the protocol used for accessing each of the data sources, sometimes called the URL 
scheme, or more generally protocol scheme, or content provider identifier. If an IMAP account source were used, the 
content provider identifier would be "imap", if a FTP server is used, then "ftp" would appear as the content provider 
45 identifier.. 

[0120] Universal content broker 113 administers universal content providers 331 . As soon as a client requests par- 
ticular content, in this embodiment, web server 320 addresses UCB 113 and passes on the corresponding URI. The 
UCB 113 analyzes the URI to detemnine the content provider identifier so that UCB can find the appropriate universal 
content provider on UCP registry 341 . The task of loading the requested data is delegated to this provider. Neither, the 
50 user of user device 102i rior web server 320 needs to know specific details about the protocol or data source. The 
content provider canies out all of the necessary steps. The protocol or data source details are thus hidden from the 
client. 

[0121] The requested data is loaded and transfen-ed to the client, in this case web server 320, as a content object. 
The content object encapsulates the requested data. The client can now run commands on the content object, to load 
55 or edit the data, for example. Similariy the internal data structure is hidden from the client, which means that it is possible 
to treat data from different sources in the same fashion. Accessing an e-mail account is therefore no different to ac- 
cessing a local file system. 

[0122] As explained above, some prior art content types can have a hierarchical structure. See Figs. 2A and 2B. 
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This applies to content objects such as those created by a file provider or I MAP provider. Users can browse through 
the different content objects or insert new content nodes into the hierarchy or delete existing ones. With other providers, 
such as HTTP, there is no relationship between the different contents. Users must know the exact location (the URL) 
to be able to access specific content. In the prior art, accessing this type of data by browsing with an explorer was not 
5 possible. 

[0123] However, as described above, hierarchy content provider 335 allows a user to classify any kind of content 
type in a virtual hierarchy as illustrated in Figure 2D. Users can define custom folders which themselves can contain 
folders or links to any content. Users can adapt this classification to match their requirements and taste. All of the 
settings made are stored in a persistent fashion and are, therefore, available when the user logs into network portal 
10 system again. 

[0124] Hierarchy content provider 335 provides portal users with a standard, expandable view of the different data 
in network portal system 100. The users can browse through the different contents with an explorer, without having to 
keep in mind which protocol is being used or what the content type is. 

[01251 As described above, universal content broker 11 3 administers different content providers 331 in network portal 
15 system 100. In one embodiment, a UCB process, which is described more completely below, is created for each user 
on-demand on a server. In one embodiment, a daemon is used to start and end processes on the server The daemon 
also builds connections between components on network portal system 100. In addition, the daemon could be used 
in conjunction with load balancing. In this case, the daemon acts as a contact for all sender components, while client 
components contact a part of the load balancer to determine on which of a plurality of servers to start a requested 
20 process. 

[01261 When started, universal content broker 113 uses the entries in configuration server 336 to determine which 
content provider (UCP) is available in the system for which protocol and then enters the corresponding details into an 
internal table, sometimes catted a provider registry. If necessary, user-specific settings are taken into account, as in 
the case of a hierarchical classification of the various data sources. 
25 [0127] Portal operators can implement their own content providers to provide additional protocols in the system or 
to integrate other infomiation systems into networic porta! system 100. Universal content broker 113 is made aware of 
this information by the corresponding entries in configuration server 336. 

[01281 As soon as a user wants to access a particular data source, the URI and conresponding configuration entries 
are analyzed to determine the appropriate content pnsvider As explained above universal content broker 1 1 3 delegates 
30 the requests to the appropriate provider This then takes care of the actual running of the data access. In this situation, 
universal content broker 113 can be seen as the contact and middleman. 

[0129] In one embodiment, data stored locally on a client can only be loaded through a web browser and so local 
data cannot be accessed by using universal content broker 11 3. As illustrated in Figure 3B, to support both the loading 
and saving of local data, an additional universal content broker 113C maybe implemented on client device 102i. By 

35 utilizing a remote access universal content provider, client universal content broker 113C can be hinged onto server 
universal content broker 1 1 3 as an additional universal content provider A file content provider could then be registered 
on the client universal content broker 113C, for example, so that the local file system can be accessed. 
[0130] Alternatively, when the user is not connected to the network, the user can use client universal content broker 
113C when using applications 305. When the user is connected to the networic a single component 390, running on 

40 the client side synchronizes client universal content broker 11 3C with server universal content broker 113. Synchro- 
nizing component 390 synchronizes messages in user mailboxes, files that were edited on local machine 102i, and 
files that were, say accessed from a browser and edited directly on network portal system 100. Synchronization of 
content also applies to multi-user operations, in which a numt>er of people may be operating on various areas of the 
content. In this situation, collision prevention is also provided. 

45 [0131] All of the settings in networic portal system 100 are stored by configuration server 336. This includes user- 
specific, application-specific and device-dependent configurations. The central storing and standard structure facilitate 
system maintenance. Instead of monitoring the status of various configuration files, an administrator views and modifies 
the settings at a central location when necessary. This central storing also allows "Roaming Profiles". A user can tog 
into networic portal system 100 through different computers from any location, as described above. In'espective of 

50 where a user is, the user always finds their usual work environment with the custom settings. 

[0132] By using configuration server 336, different kinds of information are stored in an ordered manner so that the 
information can be accessed quickly. Thus configuration server 336 contains entries for the user accounts, which 
contain the user name, password, home directory, and similar information. Configuration server 336 also holds various 
entries used to initialize applications. Each component of network portal system 100 can store and load persistent data 

55 in configuration server 336. Entries for services that have been initially integrated into network portal system 100 are 
stored in the configuration server 336 as well. 

[0133] All of the entries are stored in hierarchical form in key-value pairs. As explained more completely, below a 
configuration tree contains separate branches for this purpose, which can be used for different users or the various 
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user devices. The configuration tree is described through a Document Object Model (DOM) based on XML (Extended 
Markup Language). Communication between configuration server 336 and the various components of networtc portal 
system 100 is provided via requests for entries or requests for modification of entries. In one embodiment, the data is 
exchanged using an XML-based protocol. 
5 [0134] Alterations to the DOM tree are carried out by transactions, which include inserting new nodes or new key- 
value pairs describing user preferences. This also covers such things as modification of individual entries or deletion 
of an entire subtree as the entries are no longer needed. Configuration server 336 also contains different mechanisms 
for querying the status of transactions or registering different listeners that are notified when alterations are made to 
configuration service elements and that in turn notify the applications affected. 

AN EMBODIMENT OF PROCESSES OF NETWORK PORTAL SYSTEM 100 

[01 35] Figure 4 is a high-level process flow diagram for one embodiment of network portal system 1 00. A user inputs 
a request via a browser 304 executing on client device 102i in transmit request to web-top manager operation 401. 
15 Information In the request identifies whether the request is for content available through universal content broker 113. 
for content available from an external provider, e.g., through one of plurality of portiets 324, or for a service in remote 
applications 310 that is supported by wet)-top manager 111. 

[0136] The request from browser 304 is transmitted over a network to wel>-top manager 31 1 in transmit request to 
web-top manager operation 401 . As described above, the transmitted request includes the type of document or service 

20 requested, the type of client device 102i that is making the request, the type of the browser executing on client device 
102i, and the communication protocol that is typically part of a uniform resource locator (URL) included in the request. 
[0137] In response to the request, web server 320, which in one embodiment is ttie Tomcat server supplied by The 
Apache Software Foundation, 1901 Munsey Drive, Forest Hill, MD 21050-2747, U.S.A, determines how to process the 
request It should be noted that web server 320 may require various user authentications before access to web server 

25 320 itself, or before access to any information accessible via web server 320 is granted. The particular techniques 
used for such authentication as well as the various levels of authentication that may be used are not essential to this 
invention and so are not considered further. 

[0138] Web server 320 detemnines whether the request is for universal content broker 113 in UCB Check operation 
402. If the request if for universal content broker 113, check operation 402 ti'ansfers to provider check operation 403 

30 and othenvise to application check operation 420. 

[0139] In provider check operation 403, desktop servlet 322 uses presentation and logic service 323 to determine 
whether there are components available within service 323 to access universal content broker 113 for the type of 
information requested, e.g., for the MIME type of the information. For example, service 323 may access a user con- 
figuration file that was generated using configuration server 336 to determine whether components within service 323 

35 have been instantiated for accessing universal content broker 113 for the type of infomriation requested and for this 
user. If such components do not exist, in one embodiment, service 323 accesses a registry of factories to determine 
whetiier components can be instantiated for accessing the requested type of content, and if so uses the appropriate 
factory to instantiate the necessary components within service 323. 

[0140J In either of these cases, there are components within service 323 for interacting with universal content broker 
40 113 for the particular type of data requested and so check operation 403 transfers to access components operation 
405, and otherwise transfers to return provider error operation 404. In retum provider error operation 404, desktop 
servlet 322 generates an HTML page that is returned to client device 102i. which informs tiie user that the requested 
content is unavailable. 

[0141] In access components operation 405, service 323 passes the request to the component within service 323 
45 that supports the requested content. For example, assume that the user of client device 1 02i sent a request to network 
portal system 100 for the retrieval of content constituting a message on an IMAP server with an associated property. 
An example of a URL included in the request is: imap://user@mailserver/inbox;UID=3. 

For this URL, tine content has an associated property value UID set to 3. Thus, desktop servlet 322 passes the request 
.including this URL to the IMAP components in service 323 that process IMAP requests. The IMAP components in turn 

50 pass the request including the URL to universal content broker 113 in contact UCB operation 406. 

[0142] In contact UCB operation 406, universal content broker 113 searches a registi7 of universal content providers 
341 for the content provider associated with the URL. If a content provider for the requested content is found in a 
plurality of universal content providers 331, universal content broker 113 passes tiie request to the universal content 
provider that in turn retiieves the requested data, if necessary and returns a handle to the requested content in universal 

55 content broker content 332, and othenA/ise an error message is returned. Notice that the user device is not required to 
have software installed, or the hardware capability required to access the content via the particular protocol required. 
These details are delegated to the universal content provider. To this point tiie only requirement on the user device is 
to generate a request that can be processed by web-top manager 111. 
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[0143] Content check operation 407 determines whether a handle or an error message was returned by universal 
content broker 113. If a handle to the requested data In UCB content 332 is returned processing transfers to access 
content operation 409 and otherwise processing transfers to content unavailable error operation 408. In error operation 
408. the components within service 323 that are processing the user request generate a page that includes the error 

5 message and return that page to the user device for display. 

[0144] In access content operation 409. the components within sendee 323 processing the request use the returned 
handle to obtain the raw data from UCB content 332. This data is in a format associated with the particular universal 
content provider. Accordingly, as explained more completely below, in operation 409. information is extracted from the 
raw data and placed, in this embodiment, in a template associated with the user device that issued the request. 

10 [0145] In one embodiment, there is a set of HTML templates for browsers, a set of WML templates for WAP devices, 
and a third set of templates for hand held devices like PDAs. Within each of the three template sets, there is another 
set of content templates for each type of content, e.g., one set for an e-mail, another for an IMAP folder, and a third 
for a file system folder Within each of content template sets, there is a template for each class of user device, based 
on user device capabilities. 

75 [0146] The template selected from these sets, i.e., the template associated with the user device, is selected based 
upon information in the request from the user device, as explained more completely below. The content that is accessed 
Is in a raw data fomnat. Information is extracted from the content, as explained more completely below, and inserted 
in the template that represents a page that can be displayed on the user device, or alternatively that can t>e used to 
generate a page that can be displayed on the user device. In either case, service 323 returns a page to the user device 

20 upon completions of operation 409 that includes the requested content. 

[0147] Upon receipt of the response to the Issued request, the user device displays the page that was returned in 
display content operation 410. In some cases, the user can manipulate the displayed data, e.g., delete an e-mail 
message, and forward the content to an output device. To initiate such an action, in process content 411, the user 
device issues another request in the form of an HTTP POST request, and this request is processed via operations 402 

25 to 410 as described above. As explained more completely below, the operations performed on UCB content are not 
limited to retrieving and saving content. Properties of content can also be changed, added, updated, or perhaps deleted 
through universal content broker 113 and the appropriate universal content provider. 

[0148] The above description assumed that the request was directed to content associated with universal content 
broker 113. However, if this is not the case, the request is passed to application/service check operation 420. If a user 

30 of device 102i Issued a request to use remote applications 320 over network 103/106 to web server 320. The trans- 
mission of the request over the network 103/106 is performed according to a predetermined transmission protocol. In 
response to the request from user device 1021. web server 320 determines whether the request is for a service or 
application in remote applications 310 and if the request is for such a service or application, processing transfers to 
lightweight component available check operation 421 and otherwise to portlet check operation 440. 

35 [0149] Lightweight component check operation 421 determines whether a lightweight remote visualization compo- 
nent 311 needed to run the requested service/application is installed on user device 1021. This can be done, for example, 
by accessing a user configuration file on web server 320. or alternatively by executing a process on web server 320 
that accesses the user device and determines whether the lightweight component is installed. If the required lightweight 
remote visualization component is installed on user device 102i, check operation 421 transfers to login operation 425 

40 and otherwise to device capability check operation 422 

[0150] Device capability check operation 422 determines whether user device 1021 can execute and use the light- 
weight remote visualization component 311, e.g., is there a lightweight component 311 available for the general type 
of user device 102i, and is the operating system, processor, and memory of specific user device 102i sufficient to 
execute and support lightweight component 311. This information may be included in the initial request, a process on 

45 web server 320 may communicate with user device 102i to obtain the information, the infomiation may be retrieved 
from configuration server 336, or altematively. the request may include an identifier that is used to access some other 
database to determine the capabilities of user device 102i. 

[0151] If user device 102i is capable of executing and supporting lightweight component 311. processing transfers 
to download component operation 424 and othenvise to retum error operation 423. Return error operation 423 sends 
50 an appropriate en-or message to user device 102i to infonn the user of the incompatibility between the requested 
service/application and user device 102i. 

[01 52] Download component operation 424 downloads, and installs if necessary, lightweight component 31 1 on user 
device 1021. Thus, prior to starting login operation 310. lightweight component 311 is available on user device 102i. 
[01 53] In response to the request to access a service/application in remote applications 310, in login operation 425, 
55 a connection is established over network 103/1 06 to a daemon executing on web server 320. The daemon returns a 
handle to a daemon service factory to the lightweight remote visualization component on user device 1021. 
[0154] Upon receipt of the handle to the daemon service factory, the lightweight remote visualization component on 
user device 102i issues a request to the service factory to initiate execution of a login service.on web server 320. Upon 
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activation of the login service in login operation 425. the lightweight remote visualization component on user device 
102i transmits a user identification, a password, and options for the service/application, i.e., a runtime environment 
component, In remote applications 310 to the login service. The login sendee on web server 320 in operation 425 
validates the user login and transfers to initialize application operation 426. 

5 [01 55] While in the embodiment of Figure 4, the daemon and login service are described with respect to accessing 
a service/application. In general, a daemon process and login service are used to initiate each service supplied by 
network portal system 100 and so typically are also included within other branches of Figure 4. 
[0156] A start application operation within operation 426 activates a service factory for remote applications 310, e. 
g., runtime environment components, on web sender 320 and returns a handle to this service factory to the lightweight 

10 remote visualization component on user device 102i. Next, in a create user interface operation within initialize appli- 
cation operation 426. the lightweight remote visualization component on user device 102i issues a request to the 
runtime environment components service factory to start an infrastructure generation service. 
[0157] In response to the request, the service factory, executing on web sen/er 320. activates the infrastructure 
generation service, and returns a handle to this service to the lightweight remote visualization component on user 

15 device 1021. In a create visual infrastmcture operation, the lightweight remote visualization component on user device 
1 02i issues a request to start the infrastructure generation service, and passes a handle to a client factory to the service. 
The lightweight remote visualization component on user device 1 021 next issues a request to create a visual infrastruc- 
ture on web server 320 for processing the visual portion of tiie user interface. 

[0158] In response to the request from the lightweight remote visualization component on user device 1021, the 
20 infrastnjcture generation service first issues a request to the client factory on user device 1 02i to create a remote frame 
window, and then this service creates a corresponding server window object on web server 320. The server window 
object queries the remote frame window on user device 102i to determine the fonts, display parameters, etc. on user 
device 102i. Alternatively, the server window object can obtain identifier information from user device 102i and then 
use this identifier information to access a database that includes the display capabilities of device 1 02i via configuration 
25 server 336. 

[01 59] Upon completion of the queries, in a create environment infrastructure operation, the infrastructure generation 
service creates a frame object that controls the environment of the server window object and creates a direct connection 
between the frame object and lightweight remote visualization component on user device 1 02i . Operation 426 transfers 
to run application operation 427. At this point, a direct connection is established between user device 102i and the 

30 service/application in remote applications 310. 

[0160] In run application operation 427. lightweight remote visualization component 311 sends a command to the 
frame object to load a particular document in the service/application. In response, the frame object initiates a request 
to UCB 113 for the document. Check operation 428 passes the request to contact UCB operation 429. 
[0161] In general, operate on content check operation 428 determines whether the user has issued such an instruc- 

35 tion to save, retrieve, or replace content, or to act on a property of the content. If an instruction to operate on content 
was not issued processing returns to run application operation 427, and otherwise to contact UCB operation 429. Those 
of skill in the art will appreciate that check operation 427 is not continually performed, but rather typically is performed 
by an event processor in response to a specific user input event. 

[0162] In this case, operation 429 is similar to operation 406 that was described above. Operation 429 transfers to 
<o content check operation 430 that functions in a manner similar to operation 407. In content check operation 430, 
universal content broker 113 determines whether the operation requested in the instmction is permitted, e.g., is the 
content available through universal content broker 113, and if the content is available, is this user permitted to perform 
the operation requested. If the answer is no to either of these checks, processing transfers to retum content error 
operation 408, which in tum notifies the user that the requested operation on the content cannot be performed. 0th- 
45 enwise, the application is provided access to the content and permitted to perform the operation on the content, which 
in this case is loading the document. 

[0163] The user did not have to worry about ttie specific location at which the content was stored. To the user, the 
* content appeared as if the content was on user device 1 021. This provides the user with access to content independent 
of the location of the user, e.g., see the above example where the user was at a friend's home. 

50 [0164] After the document is loaded, the service/application reads the loaded document, and generates a display 
layout that is sent to the server window object. In tum, the server window object sends the display layout to the remote 
frame window in the lightweight remote visualization component on user device 102i. The remote frame window gen- 
erates commands to a device dependant graphic layer, e.g.. the JAVA AWT that in tum generates the user interface 
on a display screen of user device 102i. 

55 [0165] If user device 102i has limited input/output capability, the user may be able to only read the document, or 
perhaps direct the document to a local output device if the remote service/application includes such a capability, e.g., 
a capability to write to a local printer or to write to a fax printer. If a user device 102i includes multiple input/output 
devices, the user can utilize the full functionality of the service/application. For example, if the user utilizes a mouse 
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to scroll down In the document. The scroll action Is Interpreted by the windowing environment on user device 1021 and 
a scroll command is set by the windowing environment to the remote window frame of the lightweight remote visuali- 
zation component on user device 102i. 

[0 1 66] The remote window frame, in turn, sends a scroll command pver network 1 03/1 06 to the server window object 
5 on web server 320. The server window object processes the event received and generates an application event that 
In tum Is processed by the service/application. In this example, the application does a re-tayout based on the scrolling, 
and redraws the display in the server window object that in turn sends a redraw command to the remote frame window 
on user device 1021. 

[0167] In one embodiment, the transmissions over network 103/106 t>etween lightweight remote visualization com- 
10 ponent 311 and webserver 320 are enciypted according to known technologies. Further, in another embodiment, digital 
signatures are used to provide certification of the request mechanism being established on the client for this runtime 
environment component services system. 

[0168] The size of the lightweight remote visualization component on user device 1021 does not increase with the 
number of accessed runtime environment components of the implementation server framework. This Introduces the 
15 ability to offer runtime environment components, which expose only services designed for a special purpose and hide 
the complexity of the implementation framework. A more complete description of embodiments of the using services/ 
applications on network portal system 100 is described CHAPTER C below. 

[0169] Hence, the lightweight remote visualization component on user device 1021 maps visual display instructions 
from an application executing on web-top manager 111 to a platform dependent graphic layer that in tum generates a 
20 user interface on a display screen of the user device. The user Interface for the remote application is similar to the user 
interface that the user would see if the application actually were executing locally on device 1021. The interfaces may 
not be identical if user device 1021 has limited input/output capability. 

[0170] Note that the only restrictions on client device 102i are that the device must have the capability to execute a 
browser, the capability to execute the lightweight remote visualization component, and the capability to provide the 
25 input operations required by the application or service. There is no requirement that client device have preinstalled 
specialized client/server software for each application or service that is available via web-top manager 111. Conse- 
quently, the requirement for updating the specialized client/server software on each client device each time a change 
is made to an application or service has been eliminated. 

[0171] The above description assumed that the user requested an application or application service that was sup- 
30 ported by web-top manager 11 1 , or requested content supported by universal content broker 113. However, if the user 
did not request an application or an application service, or content associated with universal content broker 113, 
processing transferred from application check operation 420 to portlet check operation 440. 

[01 72] As explained above, a user initiates a request on a user device 1 02i by selecting a portlet identifier, e.g. , an 
icon, for example, that represents a particular instance of data that is accessible via a particular portlet on web server 
35 320 In this embodiment, an icon representing a portlet is only selectable for display on display screen 150 (Fig. IB) 
if the data provided by the portlet may be presented by user device 102i. For example, if the user device does not 
support graphics, a portlet, which provides data with the MIME type image/jpeg, would not be available for selection 
for display on the display screen of user device 1 021. 

[0173] In one embodiment, this pre-selection of portlets offered to the user is made by a comparison of the MIME 
40 types supported by the user device and the MIME type of data for each of the portlets. A more detailed description of 
embodiments of a process used to select portlets that may be accessed by user device 1 02i is described in CHAPTER 
D below. 

[0174] Consequently, in the following description, when user device submits a request for access to a portlet in 
operation 401 , no subsequent checking is done to assure that the requested data can be displayed on the user device. 

45 However, in another embodiment, the user is allowed to send requests to all available portlets, and as each request 
is sent, if the request cannot be processed for whatever reason, an en^or message is returned to the user device. 
[0175] The request transmitted In send request operation 401 includes at least a description of the requested data. 
Such a description may be, for example, the URL of the data. The request typically also includes the MIME type or 
types supported by the user device, e.g., wireless application protocol (WAP) for mobile phone 102j. The request may 

50 also include either or both of the identity of the user device and the identity of the user of the user device. In one 
embodiment, the request may further include a command, such as channel, load, save, or article. See European 
Patent Application entitled " A COMPUTER-BASED PRESENTATION MANAGER AND METHOD FOR INDIVIDUAL 
USER-DEVICE DATA REPRESENTATION." of Ralf Hofmann et al. 

[01 76] Portlet check operation 440 analyzes the request from user device 1 021, sometimes refen-ed to as the original 
55 request, to determine whether this request has to be processed by portlet rxianager 321 . Check operation 440 can be 
implemented in various alternative ways. In one embodiment, deployment descriptors as defined in the JAVA 2 Enter- 
prise Edition are used and checked in operation 440 to determine where to direct the user request. The JAVA 2 Platfonn 
Enterprise Edition Specification. v1 .2, Sun Microsystems, Inc.. Palo Alto, CA(1999) and the JAVA Servtet Specification . 
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v2.2, Sun Microsystems, Inc. Palo Alto, CA (1999) are Incorporated herein by reference to show the level of skill in the 
art Based upon the deployment descriptors, if the request is a portlet processing transfers to contact portlet operation 
441 and otherwise processing transfers to error operation 450 that retums a page with an illegal operation en^or to user 
device 102i. 

5 [01 77] Portlet manager 321 may be implemented in software within web server 320, or may be Installed on a separate 
computer system, which is connected or connectable to web server 320. In one embodiment, portlet manager 321 is 
implemented as a servlet that executes oh web server 320. 

[0178] Typically, portlet manager 321 is not continually executing on web server 320, and so if a request is fonwarded 
to portlet manager 321 in contact portlet operation 441 . portlet manager 321 is started and then the request is fonwarded 

10 to portlet manager 321 for processing. 

[01 79] Portlet manager 321 fonvards the request to the appropriate portlet. The fonvarding of the request to a specific 
portlet completes contact portlet operation 441. The portlet retrieves the data in retrieve data operation 442, and 
processing in portlet manager 321 transfers to a MIME check operation within identify user type operation 443. The 
request from the user device contains information at>out the presentation requirements of the requesting user device, 

15 or contains information about the identity of the user device, or contains both. If the request contains one or more MIME 
types processing transfers to a get Ml ME type from request operation within operation 443 and othenvise to an identity 
check operation within operation 443. 

[0180] In the get MIME type from request operation, portlet manager 321 extracts a list of MIME types supported by 
the user device from the request including a preferred MIME type, if a prefen-ed MIME type is specified. The get MIME 

20 type from request operation transfers to the identity check operation. 

[0181] In the identity check operation, portlet manager 321 determines whether the request included identification 
, infomiation. If identity information is included, processing transfers to a get identity from request operation and other- 
wise to retrieve scheme operation 444. The get identity from request operation retrieves the device identification from 
the request and transfers to retrieve scheme operation 444. 

25 [0182] In retrieve scheme operation 444, portlet manager 321 uses the information extracted from the request to 
retrieve a presentation scheme for the user device from a plurality of presentation schemes stored on storage unit 
accessible by web server 320. An example of a presentation scheme is an XSL style-shieet for converting the MIME 
type of the retrieved data to a MIME type that can be displayed by user device 1 02i. In one embodiment, the retrieved 
presentation scheme is loaded in a memory accessible by portlet manager 321 . Retrieve scheme operation 444 trans- 

30 fers processing to convert data operation 445. A rnore detailed process flow diagram of one embodiment of retrieve 
scheme operation 444 is presented in U.S. Patent Application Serial No. 09/xxx.xxx, entitled " A COMPUTER-BASED 
PRESENTATION MANAGER AND METHOD FOR INDIVIDUAL USER-DEVICE DATA REPRESENTATION." of Ralf 
Hofmann et al. 

[0183] When the portlet completes the retrieval of the requested data in retrieve data operation 442, convert data 
35 operation 445 is initiated. Portlet manager 321 processes the retrieved data using the stored presentation scheme to 
generate new data that can be displayed on the user device. For example, if the retrieved infomiation is a XML docu- 
ment, the XSL-stylesheet loaded in memory is used to do the transformation. If the retrieved Information is e-mail data, 
a JAVA class is used to extract the data and insert the data for example into a HTML template. 
[01 84] Convert data operation 445 transfers to retum converted data operation 446. In operation 446, portlet manager 
^0 321 retums the converted data in a HTTP response to web server 320. Web server 320 sends the HTTP response to 
the user device that sent the original request , 

[01 85] In display data operation 447, the user device processes the HTTP response, and displays the response to 
the original request on the user device. 

[0186] In this example, it was assumed that convert data operation 445 was performed on the same computer running 
45 portlet manager 321 . However, in another embodiment, retrieve scheme operation 444 and convert data operation 445 
send the retrieved scheme and retrieved data respectively to another computer system connected to the user device, 
or the user device itself. In these cases, convert data operation 445 is performed on the another computer system, or 
the user device, and retumed converted data operation 446 is performed only if operation 444 was executed on other 
than user device i02i, 

50 [0187] In the above embodiment, it was assumed that portlet manager 321 was able to identify the type of presen- 
tation requirernents for the requesting user device and retrieve a presentation scheme that converted the type of the 
requested data to a type that could be displayed on the user device. In another embodiment, a presentation scheme 
is not available to convert the retrieved data to a type of data that can be displayed on the user device. For example, 
the user requests a spreadsheet that has a data format specified by the manufacturer of the application that generated 

55 the spreadsheet. The presentation scheme available for the user device requires an input document in XML. Since 
the retrieved document in not in XML, the presentation scheme is not useful. 

[0188] However, in this situation, portlet manager 321 issues a translation request to a filter server 319. In one 
embodiment, portlet manager 321 sends a request that includes the MIME type required as input to the presentation 
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scheme for user device 1021. and an address of the requested document to filter server 319. This address can be to 
a memory where the document is stored after being retrieved by a portlet, or a URL to location of the document on the 
network. The only requirement is that filter sender 319 is able to access the requested document. 
[01 89] In response to the request; fitter server 319 builds a filter that can read the requested document, dynamically 

5 convert the read data using a partial filter adapter chain to the new format, and then write the converted data in the 
new format so that the data can be supplied to portlet manager 321 . More specifically, in response to the request from 
portlet manager 321. filter server 319 via a conversion service 315. in one embodiment, causes a protocol reader to 
be instantiated and uses the protocol reader to access the requested document to detenu ine the format of the requested 
data, i.e., the source document data format. With the source document data format and the target document data 

10 fonnat. i.e.. the MIME type received in the original request, filter server 319 builds a filter for converting the fomnat of 
source document to the format of the target document. 

[0190] In the embcxjiment of Figure 3A. filter server 319 passes the request to a conversion service 31 5 that in tum 
accesses a filter registry 316 to generate a filter map of partial filter adapters that can be chained together to convert 
the fomnat of the requested document to the MIME type specified in the request Using the filter map, conversion service 
15 31 5 calls a sendee to instantiate each partial fitter adapter in the map using partial filter adapter library 318. Conversion 
service 315 calls another service to chain the partial filter adapters together using a chaining application programming 
interface of each partial filter adapter. 

[0191] In this embodiment, filter server 319 via conversion service 315 constructs a data filter by gluing a protocol 
read and parser unit to an input end of the partial filter adapter chain and a bit stream printer and protocol writer to an 

20 output end of the chain. After construction of the data fitter, conversion service 315 uses the data filter to process the 
requested document, e.g., the spreadsheet. The data filter generates data with a MIME type that can be input to the 
presentation scheme that is retumed to portlet manager 321 , which in tum processes the data as described above. 
[0192] One important aspect of filter server 319 is that each partial filter adapter utilizes the same generic format 
independent interface to input the converted data. This allows any one partial filter adapter to t>e connected to another 

25 partial filter adapter without concern for the particular format of the data output by the first partial filter adapter. 

[0193] In one embodiment, the data filter is used dynamically, which means that the complete data file is not stored 
in the intermediate formats. Rather, the output from a first partial filter adapter is input to a second partial filter adapter 
before alt the data has been processed by the first partial filter adapter. 

[0194] A more complete description of embodiments of a filter server 319, and each of the components therein is 
30 provided In CHAPTER E below. 

[0195] In another emk>odiment, filter server 319 provides information about the dynamic data filter to portlet manager 
321. and portlet manager 321 stores a new presentation scheme that includes the dynamic data filter generated by 
filter server 319. or at least a handle to the dynamic filter, and the retrieved presentation scheme. 

35 FIRST EMBODIMENT OF PRESENTATION AND LOGIC SERVICE 323 

[0196] As indicated above, inoneembodimentof presentation and logic service 323, a plurality of providers 523 and 
a plurality of adapters 515 are used as illustrated in Figure 5. Network portal system 100 in Figure 5 includes all the 
services and components described above, but for clarity only the components needed to uriderstand tiiis embodiment 
40 of service of 323 are illustrated. Also, it is assumed that the request is issued by user device 1 02i, but the request could 
also be issued by any of user devices described herein. 

[0197] In this embodiment, in provider check operation 403, desktop servlet 322 determines whether there is a pro- 
vider object available to process the user request from operation 40 1 . In this embodiment, a provider object, sometimes 
called a provider, is associated with a content provider in plurality of universal content providers 331. For a user to 

45 access content via a universal content provider and universal content broker 113, the user must have access to a 
provider object for tiiat content. If the user already has accessed content using tiie universal content provider in this 
user session, desktop servlet obtains the handle to the provider from user configuration 501 . 
[0198] Altematively, as illustrated in Figure 6, desktop servlet 322, sometimes called a main servlet, accesses a 
device to provider configuration registry object 602, which in one embodiment is an XML file in which a provider factory 

50 for a particular content identifier and user device page type are registered. As illustrated in Figure 6, in this embodiment, 
a IHTML provider factory 603 and a WML provider factory 604 are registered in device to provider configuration regisb7 
602. Accordingly based upon the user device page type specified in the request, a provider factory object is instantiated, 
and in response to the request generates a provider for the content identifier type. In the example of Figure 6, the 
content identifier type was I MAP and so a mail provider 605 was instantiated by factory 603 if the device page type 

55 was HTML. Mail provider 605 is linked to plurality of templates 607 that were described above. In the embodiment of 
Figure 5, plurality of providers 523 includes a provider for explorer adapter 502, a provider for document adapter 503, 
a provider for mall account adapter 504, and a provider for folder adapter 505. A different content identifier, e.g.. a 
different URL scheme, is associated with each of the providers. 
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[0199] The particular adapters available to a user are determined by the content available to the user In the user's 
instance of universal content broker 113. tn particular, in one embodiment plurality of adapters 515 are provided for a 
particular user by an authentication infrastructure, which maps the user's HTTP session on web server 320 to the users' 
instance of universal content broker 1 1 3. and creates plurality of adapters 515 that are bound to this instance of universal 
5 content broker 113. In one embodiment, plurality of adapters 515 is implemented using adapter classes that are in- 
stantiated and executed on the JAVA Virtual Machine in web server 320. 

[0200] Each provider in plurality of providers 523 accesses the user's content for that provider, which is stored in 
information system tier 303, via the corresponding adapter. For example, assume that the user of client device 102i 
sent a request to network portal system 100 for the retrieval of content constituting a message on an IMAP server 542 
10 with an associated property. An example of a URL included in the request is: imap://user@mailserver/inbox;UID=3. 
For this URL, the content has an associated property value UID set to 3. Thus, desktop servlet 322 passes the request 
including this URL to mall provider 605 in plurality of providers 523. Mail provider 605 in tum passes the request 
including the URL to mail account adapter 504. 

[0201] Mail account adapter 504 passes the URL to universal content broker 113. Universal content broker 113 
15 searches a registry of universal content providers 331 for the content provider associated with the URL. If a content 
provider for the requested content is found, e.g., IMAP UCP 532, universal content broker 113 returns to mail account 
adapter 504 a handle to the requested content in universal content broker content 332. 

[0202] As illustrated in Figure 7, mail account adapter 504 receives the requested content from IMAP server 542 via 
IMAP UCP 532. The information supplied to adapter 504 is in the form of raw data-e.g., only the name of a folder or 

20 a content type. Mail provider 605 detemriines how to display the information by means of templates 607, which are 
stored in middle tier 302. There is a set of HTML templates 607 for browsers, and a set of WML templates 608 for WAP 
devices. Within each set, there is a set of templates for each type of content, e.g., one set for an e-mail, another for 
an IMAP folder, and a third for a file system folder, for example. Within each of these sets, there is a template for each 
class of device, based on device capabilities. 

25 [0203] Mail provider 605 selects the set of IMAP templates within HTML templates 607, and then selects a specific 
template for user device 1 02i using information in user configuration 501 . In general, a provider uses a template engine 
701 to process the selected template and replace the variables inside these templates, e.g., with the attributes of the 
current messages In the users inbox. In this example, mail provider 605 uses template engine 701 . In one embodiment, 
template engine 701 is implemented using JAVA classes. The result of the process by template engine 701 is a HTML 

30 or WML stream (or whatever format is associated with the client device), which is send back to the client as response. 
This means that the mode of presentation of the user interface is completely described in the template and separated 
from the content and editing this template can easily customize the user interface. 

SECOND EMBODIMENT OF PRESENTATION AND LOGIC SERVICE 323 

35 

[0204] A large part of the functionality of network portal system 1 00 is provided as simple HTML/WML pages to user 
devices. These simple pages are dynamically generated by components on web server 320 and then displayed on 
client device 102i by web browser 304. There are numerous mechanisms available to web server 320 for converting 
application logic or generating HTML pages. Anyone of the following can be used: sen/lets, Java Server Pages (JSP 
<o pages), Common Gateway Interface programs, server-side JavaScript, Active Server Pages (ASP pages) or native 
applications. The components implemented in a JAVA environment can access other applications that have been 
implemented in C++, for example, by using the bridge and proxies described above. 

[0205] In this embodiment, as described more completely below, presentation and logic service 323 uses JAVA- 
SERVER PAGES (JSPs) technology to dynamically generate HTML/WML pages that are sent as responses to client 

45 requests. (JAVASERVER PAG ES is a trademark of Sun Microsystems, Inc.) JAVASERVER PAGES technology enables 
the separation of static page design and content from the application logic, which is encapsulated in portable, reusable 
JAVA components. For an example of the knowledge of one of skill in the art with respect to JAVASERVER PAGES 
technology, see JAVASERVER PAGES Specification . Version 1.1. Sun Microsystems, Inc., Palo Alto, CA, (Nov. 30, 
1999), which is incorporated herein by reference in its entirety. 

50 [0206] In this embodiment, presentation and logic service 323 uses JAVA servlets 812 (See Fig. 8) to transform 
application logic, JSPs objects 811 to display the static portions of the HTML page, and JavaBeans objects 813 to link 
to the different content sources available through universal content broker 113. In this embodiment, two types of JSPs 
objects are used: templates and components. JSPs templates are used to organize and position common page ele- 
ments and ensure consistency of design across all pages. JSPs components are used to complete a template and 

55 create a final JSP object that is used to generate a con-esponding HTMLTWML page as explained below. 

[0207] As described above, every client request received by web-top manager 111 is accompanied by additional 
information such as the type of browser used (user agent) or the type of document requested (content type). Moreover, 
when the HTTP GET or POST methods are used for calling a specific page, additional freely selected parameters that 
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specify user-defined commands are transferred as well. 

[0208] On network portal system 100. these parameters are analyzed so that the requested information can be 
presented to client device 1021. In this embodiment of network portal system 100, this task is delegated to a profiling 
service server component 801, sometimes called profiling service 801. Profiling service 801 controls how a client 

5 request Is answered. In this embodiment. HTTP is used as the default protocol for transferring HTML pages. 

[0209] More specifically as described above, a desktop servlet 322, sometimes called a main servlet. receives the 
request. The request is then passed on to profiling service 801, which analyzes the request. Profiling service 801 
analyzes the details in the request together with other information, such as the properties of the device being used, 
and then decides which JSPs 811. servtets 812 or Beans 813 are to be employed to answerthe request. As explained 

10 more completely below, in one embodiment a decision tree determines the process flow. The decision tree Is described 
in a format based on XML, in one embodiment, and is stored in a profiling service configuration file 802. 
[0210] Different conditions from the request are checked for agreement within the decision tree. The decision tree 
effectively is a concatenation of *ir Instructions. If a condition is met. the branch associated with that condition is 
followed and the set action run. Actions are dependent on request parameters, request header parameters, device 

15 properties, and resource properties 

[0211] Device properties are the properties of client device 1021. Device properties refer to such things as display 
size on the device. These details are stored In configuration service 336 of network portal system 100 and in one 
embodiment are cached in profiling service configuration file 802 for easy access, by the components of profiling service 
801 , as required. 

20 [0212] Resource properties are all the properties that are assigned to a requested document or more generally to a 
resource. This includes, for example the various document types (STAROFFICE documents - StAROFFICE Writer, 
STAROFFICE Calc or other document formats such as PDF as well as customized content types used for folders, for 
example). 

[0213] Network portal system 100 is used with different browsers. A special add-in, e.g., lightweight remote visual- 
25 Ization component 311 described above, is required in each browser so that documents can be edited. To enable the 
dynamic download of the correct add-in, the browser type first needs to be Identified. These details are described by 
the request header parameters. 

[021 4] Furthermore, additional information may be supplied with each request to have custom commands executed. 
These additional details are termed as request parameters. To avoid transferring a large number of additional param- 
30 eters with each request, parameters are stored as attributes in a HTTP session, in one eml>odiment. In this way it Is 
unnecessary to send all the parameters with subsequent requests, instead the details of previous requests can be 
accessed. 

[0215] Profiling service 801 uses this infonnation to decide which template In templates 810 is to be used for an- 
swering the client request Furthermore, service 801 ascertains which component, e.g., JSPs component, Servlets, 
35 Java Beans component or basic HTML elements, is to be used to complete the template. The result of this is a JSP 
object to which the request itself is fonwarded. This JSP object creates a corresponding HTML page that is sent back 
to the web browser as an answer to the request. 

[0216] The actual application logic is transformed by using servlets 812. To avoid having to program servlets for 
every single basic user action, some of the basic services are provided by main sendet 322. These include the checking 
40 of user input or the renaming folders or files, 

[0217] In one eriibodiment, web server 320 is the Apache Tomcat server, as descrit}ed above. The Tomcat server 
contains a servlet engine and a JSP engine that canies out the actual creation of HTML pages. In this embodiment, 
all of the components, i.e., JSP components, servlets, Beans components, Images, etc. are combined into a single 
web archive file. 

45 

Templates 

[0218] Templates in web server 320 are used to organize the user interface in an easy manner. A standard frame 
for the presentation of HTML pages is created by defining a small number of templates. For example, a view of document 

50 storage could display all the documents of a selected folder on a particular part of a HTML page. Typically, a user is 
provided the possibility of switching between an icon view and a detailed tabular view of the document In the selected 
folder. The detail view displays not only the file name but also the size, document type, date created, etc. All other 
page elements remain the same as the icon view. This is where the use of templates is advantageous. 
[0219] In one embodiment, all pages rietumed to user device 1021 are based on the same default template, with the 

55 exception of a login page. Figure 9 Illustrates one embodiment of a basic structure of a default screen template 900. 
Visually template 900 is divided into a header area 910 and a body area 920. Header area 910. in one embodiment, 
has a daric background with a placeholder 912 framed by a logo area 911 on left side 914, and a link area 913 on right 
side 915. In this example, body area 920 has a light background and three placeholders 921, 922, and 923. 



23 



EP 1 126 681 A2 



[0220] Figure 10 is an example of a HTML page 1000 generated using template 900. HTML page 1000 is divided 
into a header area 1010 and a body area 1020. Header area 1010 Includes a series of navigational aids (shortcuts) 
1012 framed by a logo "StarPortal" 1011 and a logout link 1 01 3, which, In one embodiment are hardcode in the template. 
In this example body area 1020 includes a Current Folder component 1021, a Folders component 1022. and a Files 
component 1022. Each of components 1021 to 1022 is essentially a JSP component that is included in lieu of its 
respective placeholder. Current Folder component 1021 shows the path of the cun-ent folder. Folders component 
presents 1022 an icon view of the existing folders that belong to the My Documents link. Files component 1023 lists 
the existing files in the currently selected folder (also as icons). While in this example, each placeholder has been 
replaced with a JSP component, not every placeholder in the JSP template has to be replaced before the final page 
is generated. 

[0221] In one embodiment, most pages are functionally divided into two groups: pages that provide the option of 
folder and file management tasks, such as Bookmarks. New Documents, and My Documents pages, and pages that 
are the equivalent of menu commands and require user input such as New Folder, Rename, Mail etc. Table 1 is an 
example of the use of placeholders 912, 921 , 922, and 923 for the page list in the first row of the table. Components 
that contain the Folders, Bookmarks. RIes. and Items in Clipboard elements can alternate views t>etween an icon view 
that lists the contents of the respective element, and a detailed tabular view that shows additional information about 
the content as well as a menu of commands. 



TABLE 1.: 



Placeholders and Replacements 


Default Template 


Book-marks 


New Documents 


Clip- board 


My Document 


Commands 


Placeholder 
912 


Short-cuts 


Short-cuts 


Short-cuts 


Short-cuts 


Short-cuts 


Placeholder 
921 


Current Folder 


Current Folder 


Items in Clip- 
Board 


Cun-ent Folder 


Command Name 


Placeholder 
922 


Folders 


Folders 




Folders 




Placeholder 
923 


Book-marks 


Book-marks 




Files 





[0222] In one embodiment network portal system 100 includes at least three sets of screen templates: one set for 
every type of user device that is supported. Each set includes at least two templates: one for the login page and one 
for all other pages. In this embodiment, template WMLLoginTemplateJsp, template PQACCPPTemplate, and template 
CCPPTemplateJsp files control the client-side presentation of the network portal system Login page for WAP-, Palm 
VII-. and HTMLrbased clients, respectively The basic design and organizational structure for all other pages is defined 
by template WMLTemplateJsp, template PQATemplateJsp, or template HTMLTemplateJsp, depending on the client 
used. These templates mix JSP directives, expressions, and scriptlets with HTML. 

[0223] Figure 1 1 is an example of a portion of default HTML screen template HTMLTemptatejsp, which is represent- 
ative of the general structure of the templates. In view of the following description, those of skill in the art can modify 
the default HTML screen template for the other user devices mentioned. Near the top of the template in Figure 11 is 
a set of JSP directives, followed by the HTML header definition and tag <body>, which defines the overall organizational 
structure of the final HTML page. 

[0224] The JSP directives include a directive taglib and three page directives. Directive tagiib lists the relative URL 
referring to the tag library descriptor file {taglib.tid) that defines custom tags, as well as the prefix attribute (Starportal) 
that is used in front of custom tag names, for example, starportal: insert). After defining the header in the normal way, 
the actual structure of the future HTML page is described in the body. Different components are inserted by using the 
tag <insert>. Regular HTML tags descrit>e the positions of the inserted components on the page. In tiie example of 
Figure 11, the different components are simply listed one under the other. The content to be shown by the different 
ternis "CurrentFolder^, "CurrentFolderCommands", ''FolderViewHeader', etc. is decided by profiling service 801 , as 
described more completely below. Depending on the actual client request these could be other JSP pages or sen^lets. 
[0225] Tables 2 and 3 list the placeholder names in the HTML default and HTML login templates and their respective 
values as defined by profiling sen^ice 801. 
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Table 2.: 



10 



15 



20 



25 



30 



HTMLTemplateJsp Placeholder Names and Values 


Name 


Value 


Action 


Varies 


Title 


Varies 


Shortcuts 


fhtml/HTMLShortcuts.jsp 


CurrentFolder 


Varies 


FolderView 


Varies 


FileView 


Varies 


Error 


fhtmlfHTMLError.Jsp 



Table 3.: 


CCPPTemplateJsp Placeholder Names and Values 


Name 


Value 


Action 


Varies 


Title 


StarPortal Login 


Shortcuts 


Currently not used 


CurrentFolder 


fhtml/HTMLLoginJsp 


Cun^entFolderCommmands 


Currently not used 


FolderView 


Currently not used 


FolderViewCommands 


Currently not used 


FileView 


Currently not used 


FileViewHeader 


Currently not used 


FileViewCommands 


Currently not used 


En-or 


fhtml/HTMLErronjsp 



35 



40 



45 



50 



55 



[0226] The syntax for the value of a placeholder is defined as /folder/ name Jsp, where /folder identifies the location 
of the respective JSP that is to be included relative to the root of the network portal system 1 00 installation; and /name, 
jsp identifies the name of the JSP. 

[0227] As already explained, profiling service 801 finds the templates, JSP pages, ser^ets or Beans to be used by 
applying a decision tree. Profiling service 801 analyzes the client requests and decides, depending on the type of 
request; which JSP template file or sen/let is to be used in response to the client request using the decision tree. In 
one embodiment, the decision tree is implemented as an XML-based decision tree (ScreenRegistry.xm\), which defines 
a set of requirement types and initializes the selection made by the profiling service. 

[0228] The decision on whether to use a particular JSP template or serviet depends, in this embodiment, on require- 
ment types requestHeaderParameter, resourcePmperty, and requestParameter 

[0229] Requirement type requestHeaderParameter defmes the type of client browser ("user-agent"). This information 
is used to determine whether network portal system 100 is accessed by a WAP-, Palm VII-, or standard HTML-based 
user device. Depending on the user device, profiling service 801 selects a screen template that accommodates the 
differences in display size and functionality. 

[0230] Requirement type resourceProperty refers to the properties of a requested resource. A resource may be 
defined as a STAROFFICE document f ContentType^, other document type (such as a PDF or JPEG file), or folder. 
In general, access to documents is limited to clients that support advanced functionality such as displaying and editing 
documents. 

[0231 J Requirement type requestParameter refers to network portal system 100-defined commands ("cmd"), mod- 
ules ("modules"), and submodules ("submodute") that are processed upon request. 

[0232] Conceptually, in one embodiment, the decision tree is divided into three sections: Processing of WAP-based 
devices (See Fig. 12A); Processing of Palm VII devices (See Fig. 12B); and Processing of HTML-based devices (See 
Fig. 12C). Each section defines which requirements must be met for a certain template to be selected for that device. 
The process of analyzing and selecting a template is effectively a series of "if-then" statements. If a client request 
matches a certain requirement, ttien the decision tree initializes the use of the associated template and its components. 
In one embodiment, profiling service 801 compares request parameters with the respective requirement types in the 
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following order 

V Matching the client browser type information f user-agent^ with requirement type rec/uesfHeac/erRsramefer; 
5 2. Matching the properties of the requested resource with requirement type resourceProperty: and 

3. Matching Network porta! system 100-defined infomiation with requirement type requestParameter 

[0233] Figures 1 2A to 1 2C are a pseudo code representation of one emtxxJiment of the decision tree that implements 

10 the decision tree. Figures 13A and 13B are a portion of an actual XML decision tree. 

[0234] In general, the decision tree follows the rules of a well-fonned XML document. The decision tree includes a 
hierarchically organized data structure composed of connected nodes beginning with a root that is defined as file 
HTMLTemplateJsp. Each subsequent tag <node> defines a set of attributes that is used to select and complete a JSP 
template that is defined by tag <screen> rf a certain requirement Is fulfilled. 

^5 [0235] Requirements are defined by tag <requirement>. which has three possible attributes: type, name, and value. 
This could be the querying of specific requirements on the document type (Resource Properties), browser type (Request 
Header Parameters) or device type (Device Parameters) and also the existence of certain commands (Request Pa- 
rameters). If the condition is fulfilled by the client request, a branching off into the appropriate section takes place and 
the action contained there is executed. Otherwise the next condition (tag <node>) is used to continue. 

20 [0236] Actions can contain further conditions or define specific templates (tag <screen>) for answering client re- 
quests. It can also be the case that the individual components of the templates (tag <component>) are detemiined. 
[0237] In many cases the same condition appears in different branches of the decision tree. Substitutions can be 
defined for these cases. This substitution has been carried out, for example, for a File View component in Figure 13B. 
Depending on whether the parameter "viewTypeFiles" has a value of "icon View" or "detail View", different JSP pages 

25 are used for component FileView. 

[0238] More specifically, whether profiling service 801 selects a template associated with a WAP-based, Palm VII, 
or HTML-based user device depends on the user-agent header information provided by the client request. For example, 
if the client is a Nokia Web-enabled phone, the user-agent header information matches the requirement for processing 
WAP devices. In the decision tree this corresponds to the following element: 

30 <!- processing WAP devices -> 
<node> 

<requlrement type="requestHeaderParameter" 
name="user-agent" value="Nokia*" /> 
which is associated with the following template and components: 
35 <screen template="/wml/WMLTemplate.jsp" class="wmr> 

</screen> 

[0239] In this example, if the user accesses network portal system 1 00 fi-om a Nokia phone, the decision tree initializes 
the use of template WMLTemplatejsp, which Is used instead of the default template HTMLTemplateJsp template that 
40 is defined as the root of the XML file. 

[0240] Alternatively, If the user uses a Palm VII device, the user-agent header information matches the following 
requirement type: 

<!- processing Palm VII devices -> 
<node> 

45 <requirement type="requestHeaderParameter" 
name="user-agenr value="???PALM???*" /> 
which is associated with the following template: 
<screen template="/pqa/PQATemplate.jsp" class="pqa"> 

50 </screen> 

[0241] In this case, the decision tree initializes the use of template PQATempiate.jsp, which replaces the default 
template HTMLTemplateJsp defined in the root of the decision tree. 

[0242] By contrast, when the request is made by an HTML-based client, it is no longer necessary to match the request 
with a con-esponding requirement type for processing HTML devices, because the request did not match any of the 
55 previous requirements of the type requestHeaderParameter, the request has to come from an HTML client. 

[0243] Once the decision tree initializes the use of a device-based template, this template becomes the default for 
the cuaent request, with the exception of the login request. When a login request is received, the currently used device- 
dependent default template file is replaced with the respective login template file. This is because the login requirement 
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is listed in the decision tree as a child of the respective client browser requirement type as shown in the following 

pseudo-code: 

HTMLTemplate 

if(user-agent=WAP device) 

then(use template=WMLTemplate.jsp dass="wmn 

if( requested page IS NOT login page) 

then(use template=WMLTemplate.jsp AND its 

associated components as required per request) 
elseif (requested page IS login page) 
then(use template=WMLLoginTemplate.jsp AND its 

associated components as required per request) 
elseif (user-agent=Palm VII device) 
then(use template=PQATemplateJsp class='*pqa*') 
if(requested page IS NOT login page) 
then(use template=PQATemplate.jsp AND its 

associated components as required per request) 
elseif (requested page IS login page) 
then(use template=PQACCPPTemplateJsp AND Its 

associated components as required per request) 
[0244] If the client is identified as an HTML-based device, the decision tree initializes the use of the template 
HTMLTemplateJsp defined as the root of the document. In the case of a login request, the decision tree initializes the 
use of template CCPPTemplate, jsp, because the login requirement type is defined as a parent within the existing tree 
structure as shown above. 

[0245] Once a template has been initialized for use, the template still needs to be completed; that is. instead of its 
placeholder elements, additional components (JSP) need to be included as required per user request. The respective 
placeholders for the Shortcuts. Cun-ent Folder, Folders, and Files components are defined as illustrated in Figure 11 
following tag insert. As explained above, each component is represented by a placeholder, I.e.. componentName='' 
placeholder name", that is defined by tag insert. The ultimate value of each component is defined in the decision tree. 
(See Figs. 13A and 13B.) 

[0246] In this example, the values of placeholders Shortcuts and Current Folder \n template 11 00 (Fig 1 1) are defined 
in the decision tree in node 1310 at the top of Figure 13B as JSP files that are included in template 100 when a user 
clicks link My Documents. In the case of placeholders FolderView and FileView in template 1100, however, the value 
is defined in node 1310 as a substitute: $FOLDERVIEW and $FILEVIEW. Substitutes are a convenient way for defining 
alternate values that appear in various contexts. The value of these substitutes are defined in Figure 1 3B as elements 
1311 and 1312. respectively 

[0247] The ultimate value of each substitute depends on the client request parameters. For example, if the value of 
the client request parameter viewTypeFotders is defined as iconView, the value of placeholder FolderView is defined 
as HTMLFolderView.jsp. Likewise, if the value of the client request parameter is defined as detailView, the value of 
placeholder FolderView is defined as HTMLFolderTableView.Jsp. In all instances, the decision tree determines, which 
JSP file (or component) is included into the template so that the web server 320 can execute the resultant JSP page 
to generate the requested content of the network portal system page. 

[0248] Figure 14 the process in completing a JSP template once template 141 OA has been selected by profiling 
service 801. As described, the decision tree determines which server pages/servlets 1411A to 1411C are inserted at 
the corresponding insert tags 1411 to 1413 respectively 

AN EMBODIMENT OF CONFIGURATION SERVER 336 

[0249] Prior to considering the components for one embodiment of configuration server 336, the information stored 
and handled by configuration server 336 is described. The entries stored on configuration sender 336, in one embod- 
iment are classified in two large groups, user profiles and application profiles. User profiles describe all the user- 
dependent settings, which are not dependent on a particular application, but are specific to a domain to which a user 
belongs. These can be such entries as name and address of the portal user or details about user accounts. For example, 
a user profile can include any or all of: 

User login information such as userid, passwords/certificates for certain applications, etc.; 

User environment that includes hardware/software (type of portal device in use or available peripherals on client 

device or OS on laptop) settings, printer settings, language preference, etc.; 

Network and server settings such as which Proxy server, name server, IMAP server, Calendar server to use, ISP. 
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PPP. DNS, DHCP settings, etc.; 

User policies regarding personal data and resources, who can access them, what type of access, etc.; 
User policies regarding application choice and configuration per client device available; 
Personal settings: bookmarks, alias definition. Vacation configuration for e-mail, delegation or proxy accounts for 
5 certain tasks, etc.; and 

User application preference from a group of similar types of available applications (Outlook Express rather than 
Netscape Messenger or StarMail), application settings (the applications that must be deployed upon login), etc. 

[0250] Application profiles describe application components such as user interface components, libraries, data store 
10 schemas, etc. Application profiles also contain application default parameter values. For example, an application profile 
can include any or all of: 

Version. sen^er/URL where application should be deployed from (note that different versions of same application 
may be available through portal). libraries/DLLs used, dependencies, etc.; 
15 Vendor, distribution channel, License information; 

User interface related information such as XSL stylesheets per client device supported. XML/DTDs describing 
default values for configuration Information; and 

Default application profiles including default environment variable settings, default printer, default background/ 
foreground colors, etc. 

20 

[0251] In one embodiment, all of the application profile data is defined through XMUDTDs/Schemas. 
[0252] Configuration sender 336 is not restricted to these two groupings. Configuration server 336 typically also in- 
cludes entries for system configurations, policies and/or device-specific settings. This means various user roles with 
different access rights to system resources can be defined. In one embodiment, it is also possible to store user device- 

25 specific data such as display size. 

[0253] Figure 15 is a more detailed block diagram of one embodiment of configuration server 336. A component of 
network portal system 1501, e.g., a UCB component such as hierarchy content provider 335, or one of remote appli- 
cations 310, accesses configuration server 336 through a configuration proxy 1510 that is shown executing in Figure 
15 on web^top manager 111. However, if for example, configuration proxy 1510 is associated with hierarchy content 

30 provider 335. configuration proxy 1510 may be in infomiation tier 303. Typically, configuration proxy 1510 is in the 
same execution environment as component 1501 using proxy 1510 to access configuration server 336. One embod- 
iment of client API 1 511 of configuration proxy 1 51 0 is described below. 

[0254] As explained more completely below, configuration server 336 in response to the access by proxy 1510 com- 
municates with a configuration back end 337 to load the data in a configuration tree or to store persistent modifications. 

35 For example, UCB components or one of remote applications 310 can load entries from configuration server 336. In 
this case, configuration proxy 1510 does not start as a separate process, but as a shared library directly in the corre- 
sponding UCB component or remote application. This enables direct communication between the components and 
configuration proxy 1510. While in Figure 15, a single component 1501 and a single proxy 1510 are illustrated, typically 
each component has its own proxy and so several proxies communicate with configuration sender 336. Therefore, the 

40 following description is illustrative only and is not intended to limit the invention to the specific embodiment described. 
[0255] In this embodiment, configuration proxy 1510 provides seamless access to configuration data for client com- 
ponent 1 501 . Configuration proxy 1510 gets data from configuration server 336 on behalf of its clients, and caches the 
data in a DOM tree in proxy 1510 for optimal use. Same data may be accessed and modified by more than one client 
applications/ components, e.g. network portal system components, at the same time. Therefore, proxy 1510 has re- 

45 sponsibility to synchronize and merge data changes by different clients and to notify all clients accessing that data 
about data changes. All modifications are initially carried on the DOM tree stored in proxy 1510. Proxy 1510 reports 
collective changes to server 336 that in turn makes actual changes to DOM tree 1 570 that is described more completely 
below. 

[0256] Prior to considering the operation of the various components of server 336 in Figure 1 5, the data layout used 
50 in configuration sen/er 336 is described to facilitate the understanding of the description of the operation of the various 
components. To keep track of the configuration data modifications by the various proxies, the configuration data, in 
this embodiment, i^ stored in a single DOM tree 1570 in cache 1560 of configuration server 336. 
[0257] Figures 16A and 16B are examples of configuration tree structures 1600 A and 1600B, respectively stored in 
cache 1 560 as DOM tree 1 570. In this embodiment, only the leaves of DOM tree 1 570 can hold data. The inner nodes 
55 are used to show hierarchical relationships. Data can be of a simple type, such as integers, Boolean, strings, doubles 
or data can be of a user-defined type through templates, as described below. Binary data also can be stored in one 
embodiment. Configuration server 336 also supports the use of containers such as lists and sets. 
[0258] A template is used for more complex data types in the configuration tree. Templates describe the structure 
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of part of the configuration tree. The configuration tree itself can appear repeatedly in various parts of the configuration 
service. The information about a portal user covers details such as first and last name, company name, address, 
telephone number, fax number, etc. It would t>e cumbersome if the corresponding nodes had to be created again for 
each new user Instead, the structure of the user details is summarized as one template. This is stored in a specific 

5 location in configuration server 336. An administrator or an administration tool can refer to this template when a new 
user is created. Configuration server 336 carries out the actual setting up of the appropriate entiles. 
[0259] Templates simplify and standardize targe quantities of data. If data structures are repeated, templates are 
used for summarizing complex structures and facilitating configuration service administi'ation. A template can hold any 
type of data and is in itself a definition of new data type. Templates are often used in conjunction with sets. 

10 [0260] The data of the different portal users is confidential. A user must not have any access to settings or data 
t>elonging to other users. In addition, network portal system component 1501 does not need to know the complexity 
of the data stored in DOM tree 1570. For these reason, as soon as a user contacts configuration server 336 via proxy 
1510, a custom user-specific configuration tree view, called a merged configuration tree, is built and stored by proxy 
1510. The merged configuration tree contains the data the user can access. Figure 17 shows a merged configuration 

15 tree 1700 for user A in configuration tree 1600B (Fig. 16B). 

[0261] In many cases settings stored in DOM tree 1570 are identical for all users. An example of this is Internet 
settings, which are normally identical for all users of networic portal system 100. It would be very time consuming if 
identical values had to be manually entered and stored for each user. Configuration server 336 has the capability of 
merging parts of trees, e.g., merged nodes between a particular branch's Administrator branch and the user's branch. 

20 [0262] Hence, an administrator can define default values for the different nodes that are included in the merged 
trees. These nodes are then stored in special branches of the configuration service under "Administrator", When the 
user-specific configuration is constructed, the nodes of that user and the administrator are merged and returned to 
proxy 1510. 

[0263] This merge process can be imagined as a layering of one part-tree on top of anottier. The user tree is laid on 
25 top of the administrator tree. Specific user settings overwrite the default settings made in the administrator ti^ee and 
only those settings get added to the user subtree. For example, in Figure 1 7, the administrator default setting for SMTP 
access is overwritten by the setting made by User A. Al) of the otiier settings made by the administrator remain un- 
changed. 

[0264] In another embodiment, more than two layers of data are used. For example, different layers could be defined, 
30 which are represented by different trees of the same stixtcture. These layers could then contain various settings, e.g. 
for specific user groups or devices. 

[0265] In one embodiment, to access the individual entries in the configuration ti^ee, the entire path from the root to 
the required node is entered. For example, to access node SMTP in Figure 17 the path "Root/ApplicationProfile/Star/ 
Inet/SMTP" is used. An administrator can also issue scheme ids to facilitate access to specific entries, these scheme 
35 ids address a particular part of a particular tree. In Figure 17 the tree under "Root/ApplicationProfile/Star^ has been 
given the scheme id "com.sun.star". Therefore, the entry for the SMTP server of User A can also be accessed through 
"com. sun.star/l net/SMTP". The name of the user is accessible in a similar way by using "com.sun.star.UserProflle/ 
Data/Name". 

[0266] The data in DOM tree 1 570 is stored on configuration back end 337. A file-based system acts as the config- 
40 uration back end 337 in one embodiment. Figure 1 8 shows how the stnjcture of configuration tree 1660B (Fig. 16) has 
been applied to a series of XML files and a corresponding directory structure. A corresponding XML file usually de- 
scribes each node. The description of the subordinate trees is found in a folder named accordingly. 
[0267] Thus, only nodes ApplProfile and UserProfiie are found below the root node. This structure is described in 
file RootxmL 

45 [0268] The descriptions of the subordinate trees are found in folder Root. Files AppI Profile. xml and UserProfiie. xml 
define the structure of these t-ees. The division into XML files and corresponding folders provides a clearer represen- 
tation of configuration tree 1600B. It is also possible to store the description of an entire part-tree in a single XML file. 
However, the data that logically con-elates is typically stored in a single XML file. For example, the ti-ee for the Intemet 
settings is described in a single XML file Inetxml. 

so [0269] The files for the user-specific settings take a special role. The entire tree is stored in a single file, e.g., file 
UserAxml. This may become very complex, depending on how many default settings the user overwrites. 
[0270] Administrators normally do not have to concern themselves with user files. If settings are to be stored in the 
configuration for additional components, only the required stiucture description has to be inserted in the appropriate 
administrator branch or directory. User data is tiien updated automatically via configuration server 336. The various 

55 XML files are stored on a storage medium of configuration back end 337. 

[0271] Altematively, a database such as a relational database management system and/or an LDAP database could 
be used in configuration back end 337. In this case, it would also be possible to employ several configuration servers 
for load balancing purposes. If a database is used, configuration server 336 includes XSL stylesheets, or perhaps uses 
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dynamic data filters as descrit)ed at>ove, to convert the data as it is retrieved from the database into XML data, and to 
convert the data from XML data to data that can fc>e stored by the database. 

[0272] Since user information may be already available in LDAP databases or address book services, in one em- 
bodiment of configuration server 336. tools are provided to import such data from external sources. 
5 [0273] Typically, an administrator would extract user data from a LDAP database into a flat file and use the tool to 
convert LDAP entries into VCARD fonnat that is output into a flat file again. Address book entries can be exported into 
VCARD format and saved into a flat file. This file containing VCARDs Is then given to the Import tool, which extracts 
the information from .the VCARDs and creates configuration user records. 

[0274] Returning to Figure 15, and the management of configuration data by configuration server 336, sen/er 1520 
10 is a container class that instantiates event listener 1530 and transaction manager 1530. Server 1520 also creates 
tables, described below, in cache 1560. After initializing itself, sen/er 1520 creates a DOM tree 1570 in cache 1560 
and populates DOM tree 1570 with system policies from configuration back end 337. Server 1520 also reads in the 
master XML file, e.g., file Rootxml (Fig. 17), that describes the top level DOM tree structure below which individual 
application profiles. User preferences, etc. are added. Thus, initially DOM tree 1570 only contains nodes ApplProftle 
15 and UserProfjIe. 

[0275] To initiate connection with configuration server 336. user configuration provides, information to identify the 
user in a call to transaction openSession, This is the first transaction that must be requested to authenticate the user 
and establish a connection oriented session, a TCP session in one embodiment, that persists through multiple trans- 
actions. In this embodiment, the value of Input parameter Userlnfo passed in the call to transaction openSession is the 

20 user name. In another embodiment, login parameters are included in the transaction call. 

[0276] In configuration server 336. a listener 1530 listens for incoming connections and transaction requests. For 
every connection request, listener 1530 creates a TCP socket that provides connection-based communication between 
proxy 1510 and server 336. Each per-client TCP socket receives transaction requests from a proxy, in this embodiment. 
When a transaction request is received, this thread creates a transaction identifier, and parses the header of a trans- 

25 action envelope (See Figs. 19A to 19E) to find out what transaction is requested. The thread adds an entry at>out the 
transaction into a transaction queue table 1562 in cache 1560 that includes the transaction identifier, the session 
identifier, the transaction name, and a pointer to the XML-envelope. In this embodiment, transaction queue table 1562 
contains atl the pending transactions from all sessions. All incoming transactions are queued in table 1562 
[0277] With respect to the call to transaction OpenSession, listener 1530 processes this transaction directly. After 

30 authenticating the user, if supported, listener 1530 creates a unique session identifier and adds an entry including the 
session identification, user info, and socket info, to a session table 1561 in cache 1560. From now oh, transactions 
coming through this connection are associated with this session identifier and belong to this session, if a client (or 
monitoring Administrator console) needs to get the status of the session, the client must specify this session identifier. 
Hence, the session identifier is retumed to proxy 1510. Note that there may be more than one proxy session for the 

35 same user 

[0278] Session table 1561 keeps track of the current sessions served by configuration server 336 and contains ail 
session related information. Table 1561 is used to get client connection information when transaction responses must 
be retumed. 

[0279] After opening the session, proxy 1510 makes one or more requests to transaction openNode to get configu- 
re ration data. The call to transaction openNode tells server 336 a node should be brought Into DOM tree 1 570. The call 
may ask that a given node and all its subnodes be brought in, or the call may ask to bring in a limited number of levels 
of subnodes. In this embodiment, the input parameters In the call to transaction openNode are nodePath, numLevels 
and username. The transaction returns parameters nodeld and subNode, 

[0280] In one embodiment, input parameter nodePath specifies the uniform resource identifier (URI) of the node to 
45 be brought into DOM tree 1570. An input parameter numLevels specifies how deep the tree brought into DOM tree 
1570 should be. A value of zero indicates all the sub levels should be brought into DOM tree 1570. Input parameter 
username is an optional parameter and. in one embodiment, is allowed to be specified only by a user "Administrator^ 
to access other users' nodes. 

[0281] When event listener 1530 receives the call to transaction openNode, event listener 1530 adds an entry to 
50 transaction queue 1562. Transaction manager 1540 has the responsibility of dispatching transactions, and monitoring 
unresolved transactions. Transaction manager 1540 worics off transaction queue 1562 and does the work through a 
number of concurrent threads. For every transaction request, transaction manager 1540 adds an entry into transaction 
list table 1563 in cache 1560 and creates an instance of transaction 1550. In this embodiment, transaction list table 
1563 includes the transaction identifier, the session identifier, the transaction name, and the transaction status. 
55 [0282] Transaction 1 550 runs in a separate thread. In this embodiment, every server transaction 1 550 is defined by 
a separate class that derives from this class. The transaction parses the transaction envelope's body and extracts the 
transaction's parameters. The transaction then runs itself. When the transaction has finished processing, the transac- 
tion removes its entry from transaction list table 1563 and returns the response using the same transaction envelope 
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with changes in the header and the body. 

[0283] In transaction openNode, the transaction first makes sure that the requesting user is an Administrator if the 
optional Input parameter usemame is given. If the user is not an administrator, an error is generated and the transaction 
is not processed further. 

5 [0284] If input parameter usemame is not given, or the user is an administrator, the transaction checks if the given 
node already exists in DOM tree 1570. This means that the node must exist in the Administrator branch as well as the 
current user branch. Under some circumstances, the node may exist in Administrator branch but not in the user branch 
(different user session has already brought in the tree). If so. the node needs to be brought into the user's tree for the 
current session. If the transaction does not find an entry node table 1564, transaction 1550 gets the node from con- 

10 figuration back end 337 and adds the node to DOM tree 1570. For an XML-flat file database as illustrated In Figure 
18, this may involve opening a number of XML files and creating entries for then in node table 1564. For each XML 
file opened to satisfy this request, the transaction adds an entry to node table 1564 in cache 1560. 
[0285] Upon completion of the transaction a node identifier is returned and otherwise an error message Is returned. 
[0286] In this embodiment, the node identifier of the nodes that contain the requested node are reused, this ensures 

15 that a node in node table 1 564 is not contained by any other node in node table 1 564. Therefore, when a node is closed 
the node being closed is not the parent of any other node In the table. 

[0287] Thus, in response to call to transaction openNode, server 336 retumed a unique node identifier that identifies 
the subtree this request has opened, or another proxy already opened in a different session. From now on, this node 
identifier must be used for valid transactions on that node. All transactions working on data under this node must specify 

20 the node identifier retumed by this transaction. 

[0288] Proxy 1510 may make more than one openNode requests for the disjoined nodes that proxy 1510 needs. 
Proxy 1510 may even make duplicate requests for the same node without causing any confusion. Depending on the 
data-store used, this node may be brought in through one or more XML files/Database or LDAP queries. In one em- 
bodiment, once the node is populated inside DOM tree 1 570 in server cache 1 560, system policies and/or user profiles 

25 are checked for a given user to confirm that user has privilege to access the specified data before the data is passed 
to the client. 

[0289] Proxy 1 51 0 calls transaction openNode with a limited number of levels when the number of children existing 
under a node is needed, e.g., an Administrator may want to know how many users are registered or list all the users, 
or a user may want to know what I MAP folders are created for/by him/her. 
30 [0290] One open node request can map to one or more LDAP and/or RDBMS queries (spanning a numt>er of tables) 
internally or it may map to one or more XML files and LDAP entries. Once this configuration is done, the portal com- 
ponents do not have to have any embedded SQL queries or LDAP queries in their code. In fact, the applications do 
not need to know which database the data is coming from. The components access the data using the configuration 
server transactions 

35 [0291] Each registered server transaction has a corresponding transaction class and methods that collect or update 
the data from XML files/LDAP/RDBMS using internal queries. Transaction manager 1540 creates these transactions. 
Data retumed to proxy 1510 has a XML format (Input stream containing DOM subnode). Therefore, proxy 1510 uses 
a XML DOM API to access this data. 

[0292] In this embodiment, class DOMtree is responsible for managing DOM tree 1 570 and manipulating DOM tree 
40 1 570 according to transactions received. Transactions use this class's methods to look up data in DOM tree 1 570 and 
to update/addto/delete nodes in DOM tree 1570. 

[0293] All tables 1561 to 1565 In cache 1560 are managed through con-esponding classes that derive from a class 
LinkedList. There Is only one table of each type in server cache 1560 and each table contains information about all 
the clients/proxies that are currently logged Into configuration server 336. 

45 [0294] Notification table 1565, sometimes called notify table 1565, contains all the notification requests made by 
various proxies/clients. Table 1565 is consulted after each of the following transactions addNode, updateNode, and 
deleteNode have finished processing to check if notifications should be issued. When the client receives the notification, 
it also receives the snapshot of the node with changes. In this embodiment, each entry in table 1 565 includes a session 
identifier, a node path, and client application infprmation. 

50 [0295] Other transactions supported by this embodiment of the invention include transactions closeSession, open- 
RawNode, closeNode, updateNode, addNode, deleteNode, getStatus, cancefTransaction, requestNotify, cancelNotify, 
and addUser. Each of these transactions on server 336 is described below. The transactions described herein are 
Illustrative only and are not intended to limit the invention to either the particular transactions described or to the em- 
bodiments of the transactions described. 

55 [0298] A session on configuration server 336 is closed under different circumstances. For example, (a) proxy 1510 
wants to disconnect from server 336; (b) proxy 1510 crashes, or the machine on which proxy 1 51 0 is executing crashes/ 
shuts down, or proxy 1510 becomes very sluggish to the point that proxy 1510 can not even send close session request 
and the connection is lost; (c) proxy 1510 aborts suddenly due to networtc problems; or (d) configuration server 336 
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crashes or the server machine crashes; or configuration server 336 must be shutdown under emergency circumstances. 
[0297] In all except the last case (d) where the problem is with configuration server 336, transaction closeSession 
performs the following operations. Transaction doseSession looks for current session's entries in the notification table 
1565 and removes them. This transaction then removes all transactions except transactions updateNode, addNode 

5 and deleteNode from transaction queue table 1562 and transaction list table 1563. Transaction doseSession watts 
until currently processing and pending transactions updateNode, addNode, and deleteNode are finished, i.e., until 
those entries do not exist in the tables. Transaction doseSession, after waiting, uses transaction c/osenode to close 
the nodes opened by the current session. Next, this transaction looks for current session's entries in node table 1 564 
and removes them. Finally, this transaction removes the session entry from session table 1561. 

10 [0298] In case (d), server 336 tries to finish the above-mentioned transactions or store them In a local file. Otherwise, 
server 336 tries to send notifications about the unfinished transactions. In case (a), the client or proxy requests trans- 
action doseSession, while in cases (b) to (d). listener 1530 initiates this transaction. 

[0299] There are no input parameters in the request to transaction doseSession, ii the request is initiated by the 
proxy wishing to disconnect. An input parameter sess/on/d contains the session identifier for the session to be closed, 

15 if an Administrator console generates the request for administrative purposes. A value "ALL" is sent if Administrator 
console is shutting down network portal system 1 00 or configuration server 336 for any reason. User's privileges are 
checked before processing the transaction. This transaction returns a status identifier and status information, 
[0300] When a client, typically an administrator corisole, needs to access DOM tree 1570 as is without the merged 
tree view, transaction openRawNode is requested. This transaction is very similar to transaction openNode, but opens 

20 the node given without attempting any data merging. Note, that this node is READ.ONLY. 

[0301] In this embodiment, the input parameters in the call to transaction openRawNode are nodePath, and num- 
Leve/s. The transaction returns parameters nodeld and subNode. Input parameter nodePath is a URI. The value of 
input parameter numLevels is the same as defined at>ove. 

[0302] Transaction openRawNode first checks if the given node already exists in DOM Tree 1 570. This means that 
25 the node must exist in the Administrator branch as well as the cun-ent user branch. Under some circumstances, the 
node may exist in the Administrator branch but not in the current user branch (different user session has already brought 
in the tree). An entry is added to a Raw Node Table. If this transaction does not find an entry in the node table 1564, 
the transaction gets the node from back end 337 and adds the node to DOM tree 1570. The transaction returns either 
the node identifier or an error message. 
30 [0303] Proxy 1510 requests transaction doseNode to Indicate to sender 336 that proxy 1510 has finished using this 
data and server 336 can purge the data from cache 1560. In this embodiment, the input parameters in the call to 
transaction close/Vode are nodeld. The transaction returns parameters status/dand statusinfo. Input parameter nodeld 
is the node identifier of the node to be closed. 

[0304] This transaction first checks in node table 1564 to determine if the node identifier is valid, and if it is valid 
35 continues processing. Next, the transaction checks in transaction queue table 1562 and transaction list table 1563 to 
determine whether transactions addNode, updateNode, or deleteNode are pending for this node and if so waits until 
the transactions are finished. Next, this transaction looks in node table 1564 for nodes that have the same user name 
and if there are none, closes the user tree. The transaction then checks in node table 1564 for entries with the same 
node path, or entries that contain the node path exist. If this check is false, the transaction removes the entry from 
40 node table 1564 and from DOM tree 1570. If more than. one session had open the node, the entry for the cun-ent 
session is removed from node table 1564, and-a success response is returned. 

[0305] Transaction getNode is similar to transaction openNode except transaction getNode expects the requested 
node is already present in DOM tree 1570 in server cache 1560. Typically, transaction getNode is used to refresh a 
node or subnode of the original node requested using transaction openNode, e.g.. proxy 1510 had to discard pari of 

45 its cache that contained the node received through eariier request to transaction openNode. 

[0308] In this embodiment, the input parameters to transaction getNode are nodePath, numLevels, and username. 
Input parameter nodePath is a URI, input parameter numLevels is the same as described above for transaction open- 
Node, and input parameter username is an optional parameter that, in one embodiment, is specified only by the Ad- 
ministrator to access other users' nodes. Parameter nodeld is returned by transaction getNode for use in future trans- 

50 action references. In pariicular. requests to transactions updateNode, addNode, deleteNode must specify this node 
identifier make sure that the node is opened and available in cache 1560. Also retumed by this transaction is node 
subNode. which is the actual merged subnode received from DOM tree 1570 in cache 1560. 
[0307] Transaction updateNode is used to a accomplish number of different types of changes. This transaction is 
used to: 

55 

(a) Override default values from the Administrator tree. This effectively adds or updates (if the node already exists 
in User's branch) the user node with the new overridden value. 
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(b) Reset the overridden value back to the default value. Effectively, the subnode from the User's subtree Is deleted. 

(c) Update the default value In the Administrator's subtree, if the administrator Is requesting to change the default 
values. 

5 

(d) Add a new value to the list of values in the user's subtree. 

(e) Update values of already existing nodes. 

10 [0308] In this embodiment, the Input parameters in the request to transaction updateNode are nodetd, nodePath, 
dom_node and username. Parameter node/tf specifies a subnode In DOM tree 1570 that was opened using transaction 
openNode, Parameter nodeld refers to the subtree of which a smaller subtree Is t>elng modified. Parameter nodePath 
is the parent node under which the changes reside. Typically, parameter nodePatf) represents the smallest node that 
contains the changes. This does not necessarily have to be same node path as parameter nodePa^ given in transaction 

15 openNode, In fact, in most case this is a subnode of that node Path. Parameter dom_node Is a stream representing a 
merged DOM tree subnode. Parameter username is an optional parameter and is specified only by the user Adminis- 
trator to update other users' nodes. 

[0309] Transaction updateNode returns parameters status and subNode. Parameter status indicates success or 
failure. If the status is failure, parameter subnode is the cun^ent value of the given subnode on server 336, and otherwise 
20 the value of parameter status is zero. 

[031 0] In one embodiment, in the execution of transaction updateNode, the following operations are performed: 

1 . If Username parameter is given (Administrator is asking for data belonging to different user), the user is authen- 
ticated as being an Administrator, and if authentication fails, sends en-or response. 

25 

2. Checks in node table 1 564 if parameter nodeld is valid, and if not sends an error response. 

3. Updates node on DOM Tree 1570 and if successful, sets parameter status to zero and if not sets parameter 
status to the current value of the node for parameter nocfePaf/i in DOM tree 1570. 

30 

4. Checks In the notification table 1565 to determine which sessions need to be notified about the changes, and 
sends those notifications. While doing this, checks to detemiine if the node path updated is the target node or 
subnode of the node paths In notify table 1 565, and if true, sends notification to those sessions. 

35 5. Returns output parameters. 

[0311] Using transaction addNode, a node (containing levels of subnodes) can be added to DOM tree 1 570. Typically, 
transaction addNode is used to add user application preferences, which specify ovemding the application's default 
values. In one embodiment, transaction addNode can be used only for leaf nodes. 

40 [0312] In this embodiment, the input parameters In the request to transaction addNode are nodeld, nodePath, 
dom_node and username. Parameter nodeld is the node identifier assigned during transaction openNode. and inside 
which the new node is to be added. Parameter nodePath is the parent node path under which the given node is to be 
added. Parameter dom_node is the DOM tree subnode that is to be added. Parameter username is an optional pa- 
rameter and that in one embodiment is allowed to be specified only by the user Administrator to modify other users' 

45 nodes. Transaction addNode returns parameters status that indicates success or failure. 

[0313] Transaction deleteNode deletes a given node and its subnodes from configuration backend 337. Execution 
of this transaction follows the same pattern as described previously for transaction closeNode except the specified 
node is physically deleted. Also this transaction makes sure that deleting the given node does not make the data 
incompatible with its DTD. 

50 [031 4] In this embodiment, the input parameters in the request to transaction deleteA/ode are nodeld, nodePath, and 
username. Parameter nodeld is the node identifier assigned during transaction openNode, and inside which the node 
is to be deleted. Parameter nodePaf/i is the node path of the node to be deselected. Parameter username is an optional 
parameter, as described above. Transaction deleteNode retums parameter status that indicates success or failure. 
[0315] Using transaction getStatus, proxy 1510 can ask about the status of its transactions; or an administrative 

55 console can request status of all the transactions on configuration server 336. In this embodiment, the input parameter 
In the request to transaction getStatus is either serverld or ALL Parameter serverld is the identifier retumed in an 
acknowledgment of the request for the transaction for which the status is now being requested. In this embodiment, 
either the server identifier is the transaction identifier, or there is a con-elation between the server identifier and the 
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transaction identifier If parameter ALL is input, transaction getStatus gets the status of all the transactions for a given 
session. 

[031 6] If a client or proxy would lilce to cancel a transaction or all transactions on a particular node or all the pending 
transactions, transaction cancelTransaction is issued. In this embodiment, the input parameter in the request to trans- 
5 action cancelTransaction Is either serverfd or ALL. If serverld is input, the transaction associated with the serverld Is 
canceled. If parameter ALL is input, transaction cancelTransaction cancels all the transactions for a given session. 
This transaction returns a status of success or failure. 

[0317] If coriiponent 1 501 wishes to be notified about any changes in a subtree of DOM tree 1 570. component 1 501 
can register via proxy 1510 for such notifications by requesting transaction requestNotify. Whenever changes happen 

10 on server 336, server 336 analyzes notify table 1563 to check which proxy or proxies should be notified. In this em- 
bodiment, the Input parameters for transaction requestNotify are VectorNodes and Clientcomponent Parameter Vec- 
torNodes is a list of node paths for which tiie proxy, or client components want to receive change notifications. The 
node paths must be part of already opened DOM tree 1570. Parameter Clientcomponent is needed only if proxy 1 510 
wants to be told later by sender 336 which component had made the notification request and therefore should be 

15 notified. This ti-ansaction returns a status of success or failure. 

[0318] In one embodiment, the execution of transaction requestNotify results in the following operations: 

1 . For each node path given in the input list, a check is made to detemntne if the same session has requested 
notification for the same node earlier, i.e.. checks if for same the session identifier and node path, an entry already 

20 exists in notify table 1565. and if so. retums with success status. 

2. If an entry doesn't exist in table 1565, an entry is added to notify table 1565. 

3. Sends a success response. 

25 

[0319] A proxy that has registered for the notifications can also cancel the notifications using transaction cancelNotify 
In this embodiment, the input parameters for transaction cancelNotify is parameter VectorNodes, which was defined 
above. 

[0320] In one embodiment, in the execution of transaction cancelNotify, the following operations are performed: 

30 

1 . If the nodePath is ALL, all notification entries belonging to the current session are removed from notification 
table 1565. Othenwise, for each nodePath in the input vector, the transaction checks to see if there is an entry in 
notification table 1565 for the given nodePatii and sessionid, and if so, that entry is removed from table 1565. 

35 2. Sends a success response. 

[0321 ] As the name indicates, t-ansaction addUser is used to add new users to configuration server 336. This trans- 
action creates user entries in top-level xml files and user files under appropriate directories. 

[0322] In this embodiment, the input parameters in the request to transaction are nodeld, userfd, and dom^node. 
40 Parameter nodeld Identifies a subnode in a DOM tree that was opened using transaction openNode earlier and inside 
which the new node should be added. Parameter user/D is a unique user identifier by which the user account is identified 
within configuration server 336. Parameter dom.nocfe is the DOM subnode that must be added by this operation. Thus, 
transaction retums a status of success or failure. 

[0323] While processing the at>ove transactions, any errors are logged, in addition to returning the errors to appro- 
45 pnate proxy, the client session in an error log in server's local disk. In one embodiment, this Error log contains following 
information: 

Transaction Name; 
trans! D; 
50 Usemame; 

errorlD // default is 0; and 
error message. 

[0324] In the above description, envelopes were described. Figures 19A to 19E are illustrations of one embodiment 
55 of XML-based envelopes that can be used herein. Each envelope includes a header and a body, if the body is needed. 
Each header includes a transaction type, a ti-ansaction name, a client identifier that is assigned by proxy 1510, and a 
server identifier that is assigned by server 336. In one embodiment, the server identifier is the transaction identifier 
described above. For envelopes sent from a proxy to the server, the body includes input parameter data types and 
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values. For envelopes sent from the server to the proxy, the body includes output parameter data types and values. 
[0325] Figure 19A Illustrates one embodiment of an envelope that proxy 1510 uses to send a transaction request to 
server 336. Figure 19B illustrates one embodiment of an envelope that server 336 uses to send an acknowledgement 
of a transaction request from proxy 1510. Figure 19C illustrates one embodiment of an envelope that server 336 uses 
5 to send a response to a transaction request from proxy 1510. Figure 19D illustrates one embodiment of an envelope 
that server 336 uses to send an error notification in response to a transaction request from proxy 1510. Rgure 19E 
illustrates one embodiment of an envelope that server 336 uses to send notification of a transaction to a different proxy 

ONE EMBODIMENT OF CLIENT API 1511 OF PROXY 1510 

10 

[0326] As described above configuration data is organized in a hierarchical tree structure in proxy 1510. Entries in 
the tree structure are addressed by name. The structure of the tree is determined by a strongly typed schema. The 
schema is installed into configuration database 337. 

[0327] Tree nodes are either value nodes, which contain a single value or a list of values from a limited set of basic 
15 types; collection nodes, which contain a collection of child node of various types; or container nodes, which contain a 
variable number of entries, alt of the same type. These entries may all be values or all composite. In the first case all 
values have the same basic type, in the latter case all the subtrees have the same structure. The names of container 
entries are specified when they are created. 
[0328] Therefore, client API 1 51 1 supports: 

20 

navigating a tree structure; 

reading and updating values in the tree structure; and 

25 accessing iattributes of tree nodes, as far as they are needed for client operation. 

[0329] In this embodiment, client API 1511 also supports: 

/ fast access - both read and write even in an environment where server 336 is remote and the same configuration 
30 Is Shared by multiple clients; 

notifications about configuration changes (both local and server-initiated); 

explicit synchronization of selected parts of the configuration to enable offline client operation; and 

35 

use of specialized settings on a per-document basis that are stored within the documents. 
[0330] In addition, in one embodiment, client AP1 1511 supports: 
40 a caching implementation; 

transaction-like batching of updates; 
compound notifications for batch updates; and 

45 

notification for updates of an entire subtree of the configuration. 

[0331] In one embodiment, frequently changing configuration values are marked 'non-bound'. These values are ex- 
cluded from remote notification. This applies, for example, to settings that components generate implicitly to remember 
50 their current state (such as window positions). 

[0332] Changes originating via client API 1511 only affect a single user. Proxy 1510 needs to immediately advise 
server 336 of such changes only if there are multiple client processes acting on behalf of that user. Changes to shared 
configuration values or the schema must be applied to the DOM tree 1570 using an interface that implements the 
transactions described above. 

55 [0333] The following description of interfaces and services is one example of a client API that performs the functions 
described. This description is illustrative only and is not intended to limit the invention to the specific embodiments 
described. 

[0334] The configuration tree stored by proxy 1 510 is a recursive hierarchical tree structure, where entries are iden- 
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10 



tified by names relative to their parent (and by a composite name globally). Stepwise navigation through the hierarchy 
is allowed by interface XNameAccess. The reverse navigation is possible using interface XChildand the (local) name 
can be recovered via interface XNamed. 

[0335] Interface XNameAccess is used to access the named objects within a container. Interface XNameAccess 
inherits from Interfaces XEIementAccess and includes methods getByName, getElementNames, and hasByName. 
[0336] Method getByName returns the object with the name specified by parameter aName, Method getByName 
throws exception NoSuchElementException If an element with the specified name does not exist. This method throws 
an exception WrappedTargetException, if the implementation has internal reasons for exceptions. 
[0337] Method getElementNames returns a sequence of all element names in this container. The order of the names 
is not specified. Method hasByName returns true if the container contains the input name and otherwise false. 



TABLE 4.: Interface XNameAccess 



15 



20 



25 



30 



35 



40 



Interface XNameAccess : 

com: : sun: :star: :container: : XEIementAccess 



{ 



[const] any getByName ( [in] string aName ) 
raises ( 

com: :sun: :star: : container: : NoSuchElementException; 

com: :sun; :star: : lang: : WrappedTargetException ) ; 
[const] sequence<string> getElementNames ( ) ; 
[const] boolean hasByName ( [in] string aName ); 



}; 



[0338] Interface XEIementAccess and the other interfaces and classes used by Interface XEIementAccess as well 
as exceptions NoSuchElementException and WrappedTargetException are presented and described CIHAPTER C, 
and in particular Tables 2,3, 12 and 36 to 52 and the description thereof. 

[0339] Interface XCtiHd provides access to the parent of the object. This interface normally is only supported if the 
objects all have exactly one dedicated parent container Interface XChild Inherits from interface XInterface. Method 
getParent grants access to the object containing this content, e.g.. returns the parent to this object. Method setParent 
sets the parent to this object, and throws exception NoSupportException if the object does not allow change to the 
parent Exception NoSupportException inherits from exception Exception. 



45 



50 



55 



36 
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Interface XChild 



10 



15 



20 



interface XChild: com: :sun: :star: :uno: tXInterface 
{ 

[const] com: :sun: :star: :uno: :XInterface getParent () ; 
void setParent( [in] com: : sun: : star : :uno: :XInterface 
Parent ) 

raises ( com : : sun : : star ; : lang : : NoSupportException 



) ; 



} 



25 



[0340] Interface XNamed specifies the name of the object. The name is generally unique in the container of the 
object. Interface XA/amed inherits from interface XInterface. Method getName returns the programmatic name of the 
object. Method setName sets the programmatic name of the object to the value of input parameter aName. 



TABLE: 6.: Interface XMamed 



30 



35 



40 



interface XNamed: com:; 

{ 


sun : 


:star: :uno: : XInterface 


[const] string getName ( 


) ; 




[oneway] void setName ( 


[in] 


string aName ) ; 


}; 







45 



[0341] Interface XHierarchicalNameAccess allows direct access to a child node that Is deeper in the hierarchy. An 
object of a specific level in the hierarchy is addressed by giving its fully qualified name, e.g. "stardiv.uno.XInterface". 
\n\erlBce XHierarchicalNameAccess inherits from interfaceX/nferfece. Method getByHierarchicalName retams the ob- 
ject with the specified name and throws exception NoSuchElementException if an object with the specified name does 
not exist. Method hasByHierarchicalName returns TRUE, if an object with the spedfied name is in the container, and 
false otherwise. 



50 
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TABLE 7.: Interface XHierarchicalNameAccess 

interface XHierarchicalNameAccess : 

com: :sun: :star: :uno: rXInterface 

{ 

[const] any getByHierarchicalName ( [in] string aName ) 
raises ( 

com: :sun: :star: icontainer: : NoSuchElemehtException 



); 

[const] boolean hasByHierarchicalName ( [in] string 
aName ) ; 

); 



[0342] The fully specified name of an object is available through interface XHiemrchicalName, which offers a single 
method getHierarchlcalName() that returns the fully qualified hierarchical name of the object. lnterfaceXH/erarc/?/ca/- 
Name inherits from interface X/nte/^ce, 

[0343] To support scripting access, names are currently required to be unique regardless of case. On the other hand 
some interfaces may be case-sensitive. This difference is resolved through Implementing Interface XExactName. In- 
terface XExactName provides a method getExactName for converting an approximate name to an existing name. 
I nterface XExactName inherits from interface XInterface, 

[0344] Objects providing write access extend interface XNa me Access and interface XNameReptace, and add sup- 
port for Interface XConfa/ner. Container nodes offering write access implement interface XA/ameConfa/V?er. 
[0345] Interface XNameReplace is a generic Interface for supporting the replacement of names. Interface XNameRe- 
place inherits from interface XNameAcess. Method replaceByName replaces the element with the specified name. 
Parameter aName specifies the name of the element. Parameter aElement specifies the object to be inserted in the 
container. This method throws exception lllegalArgumentException If the element object does not support the interfac- 
es, services or other conditions, which are specified by the service of this container implementation. This method throws 
exception NoSuchElementException if an element under this name does not exist. 
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Interface XNameReplace 



interface XNameReplace: 

com; :sun: :star: : container: :XNameAccess 

{ 

void replaceByName ( [in] string aName, [in] any 
aElement ) raises ( 

com: :sun; :star: :lang: : IllegalArguinentException, 
com: :sun: :star: : container: : NoSuchElementException, 
com: :sun: :star: :lang: : WrappedTargetException ) ; 

}; 



[0346] Interface XNameContainens a generic interface for supporting the insertion and removal of named elements. 
Interface XNameContainer Inherits from interface XNameReplace. Method insertByName inserts the element at the 
specified name. Parameter aName specifies the name of the element. Parameter aElement specifies the object to be 
inserted in the container This method throws exception Illegal ArgumentExceptlon if the element object does not support 
the Interfaces, sendees or other conditions, which are specified by the service of this container implementation. This 
method throws exception ElementExistException if an element under the name exists. Exception stardiv::uno::lang:: 
WrappedTargetException is thrown if the implementation has intemal reasons for exceptions. 

TABLE 9.: INTERFACE XNameContainer 



interface XNameContainer: 

com: : sun: : star: : container: : XNameReplace 

{ 

void insertByName ( [in] string aName, [in] any aElement 
) raises ( 

com: : sun: : star: : lang: : IllegalArgumentException, 
com: : sun: : star: : container: : ElementExistException/ 
com: :sun: :star: :lang: : WrappedTargetException ) ; 

) 



Nodes with attributes and state 

[0347] Some attributes from the configuration schema need to be available to client components. These include 
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access control (read-only), whether an entry Is optional (may-be-null). and whether an entry is eligible for (remote) 
notification (bound). These are straightforwardly mapped to values (READONLY. MAYBEVOID, BOUND) from Prop- 
ertyAttribute bit mask constants. Other attributes present there could be applicable as well (MAYBEDEFAULT will 
usually be set). 



TABLE 10.: Constants PropertyAttribute 



constants PropertyAttribute 



{ 




const 


short 


const 


short 


const 


short 


const • 


short 


const 


short 


const 


short 


const 


short 


const 


short 


); 





[0348] Similarly the DIRECT. VALUE vs. DEFAULT, VALUE distinction from enumeration PropertyState applies to 
configuration nodes. Enumeration PropertyState lists the states that a property value can have. The state consists of 
two aspects: whether a value is available or void, and whether the value is stored in the property set itself, or is a 
default or ambiguous. State DIRECT. VALUE indicates the value of the property is stored in the PropertySet itself. The 
property value must be available and of the specified type. State DEFAULT. VALUE Indicates that the value of the 
property is available from a master. 



TABLE: 11.: Enumeration PropertyState 



enum PropertyState 

{ 

DIRECT_VALUE, 
DEFAULT_VALUE, 
AMBIGUOUS VALUE 
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[0349] Leveraging this mapping, a collection node provides richer access to Its members by implementing interfaces 
XPropertySet and XPmpertyState. Schema information for a collection node is then available through interface XProp- 
ertySetlnfb. 

[0350] Interface XPropertySet provides information about and access to the properties from an implementation. 
There are three types of properties: bound properties: constrained properties; and free properties. Changes of bound 
properties are obtained by interface XPropertyChangeiistener. Changes of constrained properties are vetoed with 
interface XPropertyVetoListener. Method getPropertySetinfo returns the interface XPropertySetlnfo, which describes 
all properties of the object, which supplies this interface. Method setPropertyVaiue sets the value of the property with 
the specified name. If it is a bound property the value will be changed before the change events is fired. If it is a 
constrained property a vetoable event is fired before the property value can be changed. Method getPropertyVatue 
returns the value of the property with the specified name. Method addPropertyChangeUstenerad6s an interface XProp- 
ertyChangeUstener to the specified property. An empty name CI registers the listener to all bound properties. If the 
property is not bound, the behavior is not specified. Method removePropertyChangeUstener removes an interface 
XProperfcyCtiangeUstener irom the listener list. This method is a "noop" if the listener is not registered. Method ad- 
dVetoat)leChangeUstener adds an interface XVetoableChangeUstenerio the specified property with the name Prop- 
ertyName. An empty name registers the listener to all constrained properties. If the property is not constrained, the 
behavior is not specified. Method removeVetoabieChangeUster}er removes an interface XVetoableChangeUstener 
from the listener list. This method is a "noop" if the listener is not registered. 

TABLE 12.: INTERFACE XPropertySet 



interface XPropertySet: com: :sun: :star: :uno: :XInterface 
[const] com: : sun : : star : : beans: : XPropertySetlnfo 

getPropertySetinfo ( ) ; 
void setPropertyVaiue ( [in] string aPropertyName, [in] 

any aValue ) 
raises! 

com: : sun : : star : : beans : : UnknownPropertyException, 
com: rsun: :star; : beans: : PropertyVetoException, 
com: : sun : : star : : lang: : IllegalArgumentException, 
com: : sun: : star: : lang: : WrappedTargetException ) ; 
[const] any getPropertyValue ( [in] string PropertyName 
) 

raises { 

com: : sun: : star: : beans: : UnknownPropertyException, 
com: : sun: i star: : lang: : WrappedTargetException ) ; 
void addPropertyChangeListener ( [in] string 
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a Pr opert yName , [in] 

com: :sun: :star: : beans: :XPropertyChangeListener 
xListener ) 
raises ( 

com: : sun: :star: :beans: : UnknownPropertyException, 
com: : sun: ;star: : lang: : WrappedTargetException ) ; 
void removePropertyChangeListener ( [in] string 
aPropertyName, [in] 

com: :sun: :star: : beans: :XPropertyChangeListener 
aListener ) 
raises ( 

com: : sun: : star: : beans : : UnknownPropertyException, 
com: : sun : : star: : lang : : WrappedTargetException ) ; 
void addVetoableChangeListener { (in] string 
PropertyName, [in] 

com: :sun: : star :: beans : :XVetoableChangeListener 
aListener ) 
raises ( 

com: : sun: :star: : beans: : UnknownPropertyException, 
com: : sun: : star: : lang; : WrappedTargetException ) ; 
void removeVetoableChangeListener ( [in] string 
PropertyName, [in] 

com: : sun: : star: : beans : : XVetoableChangeListener 
aListener ) 
raises ( 

com: : sun : : star : : beans : : UnknownPropertyException, 
com: : sun: : star: : lang: : WrappedTargetException ) ; 



[0351] Interface XPmpertyState makes it possible to query infonnation about the state of one or more properties. 
The state contains the information if a value is available or void and if the value is stored in the object itself, or if a 
default value is to be used and if the value cannot be detemiined, due to ambiguity. Interface XPmpertyState Inherits 
from interface X//7ferfece. Method getPropertyState returns the state of the property. Method getPmpertyStates returns 
a sequence of the states of the properties, which are specified by their names. The order of the states Is correlated to 
the order of the given property names. Method setPropertyToDefault sets the property to default value. The value 
depends on the implementation of this interface. For a bound property, the value must be changed before the change 
events are fired. For a constrained property, the vetoable event must be fired before the property value is changed. 
Method getPropertyDefault returns the default value of the property with name PropertyName. If no default exists, is 
not known, or is void, the return type is void. 



42 



EP 1 126 681 A2 

TABLE 13-: Interface XPropertyState 



interface XPropertyState: 

com: : sun: : star: : uno: rXInterface 

{ 

com: :sun: :star: : beans: : PropertyState get PropertyState ( 
[in] string PropertyName ) 
raises ( 

com: :sun: :star: : beans: :UnknownPropertyException ) ; 
sequence<com: :sun: ;star: :beans: : PropertyState> 
getPropertyStates ( [in] sequence<string> 
aPropertyName ) 
raises ( 

com: :sun: :star; : beans: : UnknownPropertyException ) ; 
void setPropertyToDefault ( [in] string PropertyName ) 
raises ( 

com: :sun: :star: ; beans: : UnknownPropertyException ) ; 
[const] any getPropertyDefault ( [in] string 
aPropertyName ) 
raises ( 



com: : sun: : star: :beans : : UnknownPropertyException, 
com: : sun: : star: : lang: :WrappedTargetException ) ; 



[0352] Interface XPropertySetlnfb specifies a set of properties. The specification only describes the properties, it 
does not contain any values. Interface XPropertySetlnfb inherits from interface Xfnterface. Method getProperties re- 
turns a sequence with all property descriptors, which are specified within this interface XPrope/tySe//nfo. Method get- 
PropertyByName returns the property with the specified name from the object. Method hasPropertyByName returns 
TRUE If a property with the specified name exists and otherwise FALSE is returned. 
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TABLE 14.: Interface XPropertySetlnfo 



interface XPropertySetlnfo : 

com: : sun: rstar: :uno: :XInterface 

{ 

[const] sequence<com: ;sun: :star; : beans: : Property> 

getProperties ( ) ; 
[const] com: : sun: rstar: : beans: : Property 

getPropertyByName ( [in] string aName ) 

raises ( 

com: rsun: : star : ibeans : : UnknownPropertyException ) ; 
[const] boolean hasPropertyByName ( [in] string Name ); 

} 



[0353] The relation of the property set interfaces just described to the hierarchical container described above is 
characterized by the equality: 

node.getPropertyValue (name) = node.getByName (name) 

[0354] Other interfaces may also be supported in API 1 51 1 , Interface XMultiPropertySet is usually available. Inter- 
faces XPmpertyAccess or XFastPropertySet are possible extensions. Interface XFastPmpertySet, If present, provides 
handles that are unique within the whole registry (or at least the whole subset in use). Typically, the property sets must 
not be dynamic, so these interfaces are not available on container nodes. On objects providing only read-only access 
the property set information will still reflect the access rights granted by the schema, but methods setPropertyValue(), 
setPropertyToDefaultO, etc. throw an appropriate exception. 

[0355] I nterf ace XMultiPropertySet provides access to multi pie properties. I nterf ace XMultiPropertySet inherits from 
Interface XInterface. Method getPmpertysetlnfb returns the interface XPropertySetlnfo, which describes all properties 
of the object to which this interface belongs. NULL is returned if the object cannot or will not provide information about 
the properties. Method setPropertyValues sets the values to the properties with the specified names. The values of 
the properties must change before the bound events are fired. The values of the constrained properties should change 
after the vetoable events are fired and after if no exception occurs. Unknown properties are ignored. Method getProp- 
erty Values returns a sequence of all values of the properties, which are specified by their names. The order of the 
values in the returned sequence will be the same as the order of the names in the argument. Method addPropertie- 
sChangeUstener a66s an interface XPropertiesChangeUstener to^he specified property with the specified names. 
The implementation can ignore the names of the properties and fire the event on all properties. Method removeProp- 
ertiesCtiangeUstener removes an interface XPropertiesChangeListener from the listener list. This method is a noop 
if the listener is not registered. Method firePropertiesChangeEvent f\res a sequence of Property Change Events to the 
specified listener 



44 



EP 1 126 681 A2 

TABLE 15.: Interface XMultiPropertySet 



interface XMultiPropertySet: 

com: : sun: : star : :uno: :Xlnterface 

{ 

[const] com: :sun: :star: : beans: :XPropertySetInfo 

getPropertySetInf o { ) ; 
void setPropertyValues ( (in) sequence<string> 

PropertyNames, [in] sequence<any> Values ) 

raises ( 

com: :sun: rstar: :beans: : PropertyVetoException, 
com: : sun: :star : : lang: : IllegalArgumentException, 
com: : sun: : star: : lang : : WrappedTargetException ) ; 

[const] sequence<any> getPropertyValues { [in] 
sequence<string> aPropertyNames ) ; 

[oneway] void addPropertiesChangeListener ( [in] 
sequence<string> aPropertyNames, [in] 
com: :sun: ;star: : beans; :XPropertiesChangeListener 
xListener ) ; 

[oneway] void removePropertiesChangeListener { [in] 

com: :sun: :star: :beans: : XPropertiesChangeListener 
Listener ) ; 

[oneway] void f irePropertiesChangeEvent ( [in] 
sequence<string> aPropertyNames, [in] 
com: :sun: :star: rbeans: : XPropertiesChangeListener 



xListener ) ; 

} 



[0356] Interface XPmpertyAccess makes it possible to access all multiple property values and to set them at once. 
In most cases this interface is in addition to interface XPmpertySet. Interface XPropertyAccess is especially useful for 
remote communication because this interface lessens the number of calls for getting property values. This is especially 
important because these calls are necessarily synchronous. Another advantage of this interface is that conflicts are 
avoided if property value restrictions depend on the value of other properties 

[03571 Interface XPmpertyAccess inherits from interface XInterface. Method getPmpertyvatues returns a sequence 
of alt property values within the object in a single call. Method setPropertyValues sets the values of given properties. 
AH properties, which are not contained in the sequence, are left unchanged. 



45 



EP 1 126 681 A2 

TABLE 16.: Interface XPropertyAccess 



interface XPropertyAccess: 

com: ; sun: : star : : uno: iXInterf ace 

{ 

[const] sequence<com: :sun: :star: : beans: : PropertyValue> 

getPropertyValues ( ) ; 
void setPropertyValues { [in] 

sequence<coin: :sun: :star: : beans: : PropertyValue> 

aProps ) 

raises ( 

com: :sun: :star: : beans: :UnknownPropertyException, 



com: :sun: :star: : beans: : PropertyVetoException, 
com: :sun: ;star: :lang: : IllegalArgumentException, 
com: :sun: :star: :lang: : WrappedTargetException ) ; 



[0358] As indicated above, interface XFasfPrope/tySef provides a fast way of accessing and changing property val- 
ues. This interface is an extension to Interface XPropertySe/. Methods getFastPropertyValue and setFastPropertyValue 
use handles to access the property values Instead of character strings. 
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TABLE 17.: Interface XFastPropertySet 



interface XFastPropertySet: 

com : : sun : : s tar : : uno : : XInter f ace 

{ 

void setFastPropertyValue { [in] long nHandle, [in] any 
aValue ) 
raises ( 

com: :sun: :star: : beans: : UnknownPropertyException, 
com: :sun: :star; ; beans: ; PropertyVetoException, 
com: :sun: rstar: rlang: : IllegalArgumentException, 
com :: sun :: star : : lang : : WrappedTargetExcept ion ) ; 
[const] any get Fast PropertyValue ( [in] long nHandle ) 
raises ( 

com: : sun : : star : : beans ; :UnknownPropertyException, 
com: : sun:; star: :lang: : WrappedTargetExcept ion ) 

} 



Batch Changes and Notifications Support by AP1 1511 

[0359] Component 1 501 can obtain objects that provide write access to configuration tree. These objects collect the 
changes made and transfer the changes to proxy 1511 all at one time. An object that collects changes, which are 
eventually committed offers interface XChangesBatch, Interface XChangesBatch inherits from interface Xtnterface. 
Method commitChanges commits locally accumulated changes to become persistent and makes the changes available 
to other dients that access the configuration tree. Interface XChangesBatch also offers methods to query the accu- 
mulated changes, e.g., methods hasPendingChanges and getPendingChanges. 

[0360] Method getChangesQ in interface XChangesSet provides access to a set or sequence of change descriptions 
and a context. Change descriptions are just structures having accessor (path to changed item), new Value and old 
Value. The context specifies the common root of all changes. A set of change descriptions obtained by interface 
XChangesSet obtained from an object supporting interface XChangesBatch, have the source object as root. Other 
services may. have different spedfi cations. 

[0361 ] Any accessor object also offers compound notifications through interface XChangesNotifier. A batch of chang- 
es originating from either a local method XChangesBatch::commitChanges() or a remote synchronization broadcast 
a Changes Event to interface XChangesListeners. A changes event again contains a set of Interface XChangesSet 
change descriptions. An interface XC/janges/Jsfener registered for a composite registry node, is notified of any change 
in the subtree. 

[0362] For completeness, the property set and container event interfaces are also supported (e.g. for clients inter- 
ested in only a single registry entry). 

Additional Interfaces of API 1511 

[0363] The initial access point for configuration sender is a service Configuration Provider. Service ConfigurationPro- 
vider implements interfaces to control the connection to configuration server 336 and to allow explicitly synchronizing 
a local registry copy for offline operation. Service ConfigurationProvidera\so offers an interlace XConfigurationProvider, 
which has factory methods createConfigurationAccessQ and createConftgurationUpdateQio obtain a Name Hierarchy 
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object for a configuration subtree with or without write access. Service ConfigurationProvider a\so may offer an Interface 
to provide hints to a caching implementation, which configuration entries wilt soon be needed and therefore should be 
preloaded. Finally, service ConfigurationProvider includes interfaces for importing and exporting a registry subtree as 
XML 

5 

Object Model for API 1511 

[0364] As mentioned above, access to configuration server 336 Is started through one-instance service Configura- 
tionProvider This object holds the master copy of the registry for component 1 501 . This object coordinates overlapping 

10 requests and maintain a pooled notification link to server 336. Through Interface XConfiguration Provider interface, 
dient components can obtain accessor objects for either read-only or writing access. The object model can be illustrated 
using the MVC pattem: service ConfigurationProvider serwes as the global model; A service ConfigurationAccess pro- 
vides a view onto a specific part this model. A service Configuration Update obtained from service ConfigurationPro- 
vider, provides a derived model (for a specific part of the registry) for use by a controller. If additional clients need to 

15 observe this local model before it is integrated into the master registry, they can attach to the sen/ice Configuration- 
Update or its descendents. 

Read-only vs. Write access 

20 [0365] An instance of the read-only service ConfigurationAccess provides a direct view on a subtree of the 'master* 
registry. Service ConfigurationAccess Implements services NameHierarchy lor navigating the subtree and reading val- 
ues. Where appropriate the Property Set interfaces are available to query more schema-related information. The event 
interfaces mentioned above, are available on service ConfigurationAccess. The event interfaces can be used to receive 
notifications about changes either local or from a remote server 

25 [0366] Navigation to a descendant element obtains an instance of service ConfigurationAccess for the subtree that 
also directly reads the master registry. To make changes to the registry, an instance of service ConfigurationUpdate 
must be obtained. This service offers the same interfaces as service ConfigurationAccess, augmented by additional 
interfaces for write access. 

[0367] This object behaves like a local copy, detached from the 'master* registry in proxy 1511 . This object collects 
30 changes made through this object and descendant objects obtained from it. This object implements interface 
XCf)angesBatcf), which must be used to integrate the accumulated Changes Set into the master registry tree In proxy 
1511. 

[0368] Navigation to descendant objects therefore provides update access, but updates initially affect only the 
ChangesSet of the original ConfigurationUpdate object 
35 [0369] Event handlers registered on such an object are notified of changes immediately. This means that such chang- 
es are not persistent if they are not committed in the end. 

[0370] On an instance of service ConfigurationUpdate, the Property Set interfaces permit changes to value or state 
of a property. Also, Interface XNameReplace may be used to substitute a whole subtree. For (extensible) container 
nodes interface XA/a/neConfa/ner permits addition or removal of entries. As only complete subtrees having the appro- 
ve priate structure for an entry may be added or substituted, a container node also supports a factory interface that allows 
creation of such a subtree, initialized to suitable defaults. In one embodiment, this factory interface is an interface 
XSingleSen/iceFactory, 

[0371] Forced use of interface XCt)angesBatch ensures that clients support caching implementations and remote 
notification mechanisms to operate efficiently. 
45 [0372] An explicit preferences user interface keeps service ConfigurationUpdate open until committing or aborting 
the update on close. Clients that frequently update non-shared settings may just operate on their local copy, commlting 
changes only rarely (maybe at session close). Clients that only need read-only access can always operate on current 
data. 

[0373] Commlting changes through XChangesBatch partially supports transaction semantics. They are atomic and 
50 isolated in the sense that other local clients see only either old or new values. Registered observers are notified of the 
changes during this change. Committing updates through different ConfigurationUpdates serializes these updates. A 
collection of changes originating from the server behaves similariy. 

APIs FOR USE WITH ONE EMBODIMENT OF UCB 113 

55 

[0374] An overview of the framewori< for implementing one embodiment of information tier 303 in network portal 
system 1 00 is presented using interface definition language files. Via these interfaces, the following operations can be 
achieved: content is provided; content is obtained from content providers; content is defined; properties of content are 
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set. updated, read, deleted; components are notified about changes in content. The interfaces may be implemented 
in software and/or hardware components. Moreover, computer code Implementing the interfaces can be contained In 
a computer program product. Also, Interfaces described elsewhere in this detailed description could also be used as 
appropriate. 

CONTENT PROVIDING. 

[0375] Network portal system 100 provides services to register and maintain implementations of content provider 
systems. Content provider systems are classified according to what uniform resource locator (URL) schemes they 
implement For Web sites, the scheme Is HTTP. For I MAP or FTP sites, the scheme is (respectively) Imap or ftp. 
[0376] Thus, given a URL, the scheme may be obtained. If a content provider system is registered with the con^e- 
sponding URL scheme then content may be obtained for the URL. 

[0377] The main network portal service that manages universal content providers 331 Is a service UniversalContent- 
Broker, which is a one-instance service, and which is universal content broker 113. In one embodiment, as presented 
below, service t//?/ve/sa/ConfenfBro>fer implements four interfaces: 1) an interface XContentProvider: 2) an interface 
XContentProviderManager; 3)an interface XContentldenttfierFactory; and an interface XComponent, each of which is 
described more completely below. In the following description, the name of the Interface is Indicative of the type of the 
interface, e.g. interface XConfen/ProWder Is an interface used to provide content. 



TABLE 18.: Service UniversalContentBroker 



service UniversalContentBroker 
{ 

interface com: :sun: :star: :lang: rXComponent; 
interface com: :sun: :star: :ucb: : XContentProvider ; 
interface com: :sun: :star: :ucb: : XContent ProviderManager; 
interface 

com: :sun: : star; :ucb: : XContent IdentifierFactory; 

}; 



[0378] Interface XComponent must be implemented to make it possible to resolve cyclic object references. Cyclic 
object references may occur if content provider implementations hold references to universal content broker 113. Uni- 
versal content broker 113 itself always holds the references to content providers In universal content providers 113. If 
universial content broker 1 13 is released, method dispose in interface XComponent must be called at universal content 
broker 113. The implementation of method dispose calls method disposing In interface XEventUstener, on the regis- 
tered listeners, i.e., the universal content providers 331 registered with universal content broker 113, and releases the 
appropriate object references. On the other hand, the implementation of method disposing In interface XEventListener 
must release the appropriate references, as described more completely below. 

[0379] interface XconfenfProwder provides access to all content, independent of the kind of content, provided by 
registered content providers in universal content providers 331. Interface XConfenfProwde/iManager provides access 
to a set of content providers registered with universal content broker 113. inteiiace XContentldentifierFactory creates 
content identifiers. Interface XContentldentifier implements methods for maintaining a URL. 
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TABLE 19.: Interface XCOMPONENT 



10 



interface XEventListener; 

interface XComponent: com: : sun: : star :: uno: rXInterf ace 
{ 

void dispose () ; 

void addEventListener([in] XEventListener xListener ); 



15 
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25 



30 



35 



void removeEventListener ( [in] XEventListener aListener 



) ; 



[0380] Interface XComponent inherits from Interface Xlnterface. An owner of an object calls method dispose In in- 
terface XComponent to dispose of the object. Only the owner of the object calls method dispose if the object should 
be destroyed. All objects and components must release the references to the objects. If the object is a broadcaster, 
all listeners are removed and method XEventUstener::disposing() is called on all listeners. 

[0381] Due to the importance of the concept of method XComponent: .disposed a figurative example is provided. 
Imagine there was a hole in the floor and some people around it were holding a box (our component). Everyone who 
holds the box for a longer time than just temporarily (i.e. to put something in or get something out) has to watch a light 
bulb, which is attached to the box (listening to event XEventListener-disposingQ). Now, when the owner of the box 
switched the light on (calling method XComponent::disposeOl everybody holding the box had to take their hands off 
(clear the interface handles). If and only if everyone did that, did the box fall (getting deleted). However, only the owner 
is allowed to switch the light on! After method dispose is called, the instance has to throw exception DisposedException 
for all non-event-method calls and event-method calls have to be ignored. 
[0382] The following is an example of one embodiment. 
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void dispose 0 
{ 

^ // make a copy 

Listener [] aTmpListeners = MyListeners . clone () ; 

10 // clear all listeners (against recursion) 

MyListeners. clear ( ) ; 



// call all listeners 

EventObject aEvt = new EventObject ( ) ; 

aEvt.xSource = this; 

for( i = 0; i & It; aTmpListeners . length; i++ ) 

aTmpListeners [i] . disposing { aEvt ) ; 

} 



25 [0383] Method addEventUstener in interface XComponent adds an event listener to the listener list for the object. 
The broadcaster fires the disposing method of this listener if method XComponent::dispose() is called. Conversely, 
method removeEventListener removes an event listener from the listener list for the object. 

[0384] Interface XEventListener is a tagging interface that all event listener interfaces must extend. Interface 
XEventUstener inherits from interface Xlnterface. Method disposing is called when an event broadcaster is about to 
30 be disposed. All listeners and all other objects, NA^ich reference the broadcaster, should release the references 



TABLE 20.: INTERFACE XEventListener 

35 , 



40 



interface XEventListener: 

com: : sun: : star: :uno: :XInterface 

{ 



45 



50 



void disposing ( [in] com: : sun :: star :: lang: : EventObj ect 
Source ) ; 

}; 



[0385] structure EventObject specifies the base for alt event objects and identifies the source of the event, i,e„ the 
object that fired the event. 
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TABLE 21.: Structure EventObject 



struct EventObject 
{ 

com: :sun: : star: :uno: rXInterface Source; 
}; 



[0386] Interface XInterface is the base interface for other interfaces and provides lifetime control by reference count- 
ing. Interface XInterface also provides the possibility of querying for other interfaces of the same logical object. Logical 
object in this case means the interfaces that actually can be supported by internal, i.e., aggregated, physical objects. 
[0387] Method querylnterface in interface XInterface queries for a new interface, specified by the Type, to an existing 
object. Method acquire increases a reference counter by one, while method release decreases the reference counter 
by one. When the reference counter reaches a value of zero, the object is deleted. 



TABLE 22.: INTERFACE XIntBrface 



interface XInterface 
{ 

any querylnterface ( [in] type aType ); 
[oneway] void acquire (); 
[oneway] void releaseO; 
}; 



[0388] The real lifetime of an object is controlled by references kept on interfaces of the object. There are two distinct 
meanings in keeping a reference to an interface: the first meaning is to own the object, and the second meaning is to 
know the object. 

[0389] To prevent cyclic references from resulting in failure to destroy an object, references of interfaces to the object 
are allowed only (i) by the owner, (ii) if the reference is very temporary, or (iii) you are registered as an Event Listener 
at that object and cleared the reference when method disposing is called. 

[0390] Service UniversalContentBrokermp\en\en\s interface XContentProviden Interface XConfen/Prowc/er inherits 
from interface X/nferfece. Through interface XConfenfProWder, a content provider in universal content providers 331 
may generate new content for all URL schemes for which the content provider is registered with universal content 
broker 113, and a client does not have to query all content providers to determine which content provider should be 
used. Content is generated for universal content broker 1 1 3 via method queryContent, which takes an identifier of type 
interface XContentldentlfier, which is described more completely below, and returns the content if the given identifier 
matches the content provided by the implementation of interface XContentProviden If the given identifier does not 
match an identifier for content provided by the implementation of this interface, exception lllegalldentifierException is 
thrown. 
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TABLE 23.: INTERFACE XCONTENTPROVIDER 



5 



interface XContentProvider : 



com: :sun: :star: :uno: :XInterface 



10 



com: : sun: : star: : ucb : : XContent queryContent ( 
[in] com: :sun: :star: :ucb: : XContentldentif ier 
Identifier ) 
raises ( 

com: :sun: :star: :ucb: : Illegalldentif ierException 
) ; 



30 [0391] Method compareContentlds in interface XContentProvider \s used for several reasons. It may be necessary 
to check the object identity of UCB contents, e.g., if a software system manages the HTTP cache as a list of interfaces 
XContent (Interface XContent is described below) and one URL is requested from this cache, it is necessary to identify 
the right reference within this list, if the reference is present there. This cant be done by comparing the string repre- 
sentation of interface XContentldentifier because the same content can be referenced by different U RLs. The provider . 

35 is the only one, who can perform this identity check in the right semantic way For example: 
idl := 

ucb. createContentldentifier("http://my domain") 
id2:= 

ucb.createContentldentifierChttp://1 67 .345. 12.1") 
40 if(id1 .getContentldentifier() == 

id2 . getContentldentifier ()) 

is never be true, and is a meaningless comparison 
if (ucb.compareContentlds(id1 , id2) 
could be true, this tests the object identity. 
45 [0392] One embodiment of exception lllegalldentifierException is presented in Table 24. This exception is thrown to 
indicate an illegal content identifier 
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long 
[in] 
[in] 

}; 



compareContentlds ( 

com: :sun: :star: :ucb: : XContentldentif ier Idl, 
com: : sun: : star : : ucb : : XContentldentifier Id2 ) ; 
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TABLE 24.: Exception IllegalldentifierException 



exception IllegalldentifierException: 

com: : sun: :star : :uno: : Exception 

{ 

}; 



[0393] Exception IllegalldentifierException in interface XContentProvlder inherits from exception Exception in Table 
25. Exeception Exception is the basic exception and all exceptions are derived from this exception. 
[0394] Message specifies a detailed message of the exception or an empty string if the callee does not describe the 
exception. Context is an object that describes the reason for the exception. Context may be NULL if the callee does 
not describe the exception 

TABLE 25.: Exception Exception 



exception Exception 
{ 

string Message; 

com: : sun: : star: :uno: iXInterf ace Context; 
}; 



[0395] Content provider objects implementing interface XContentPrnvidernyay register and de-register with universal 
content broker 113 with con-esponding URL schemes using inieriaceXContentProviderManager. 
[0396] Method Input parameter Provider is the content provider to register. Input parameter Scheme is the URL 
scheme for the content provider If input parameter ReplaceExisting Is true, a provider possibly registered for the given 
scheme is replaced. The replaced provider is not deregistered automatically. If the superseding provider gets dereg- 
istered, the superseded one becomes active again. If input parameter ReplaceExisting /s false, the input content pro- 
vider is not registered, if another provider is already registered for the given URL scheme. If a content provider object 
attempts to register a URL scheme that already is registered with universal content broker 113, method registerCon- 
tentProvider throws an exception DuplicateProviderException, which is further defined in Table 28. 
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tion is thrown to indicate that a content provider with the same identifier already was registered with a content provider 
manager. 

TABLE 28.: Exception DupllcateProviderException 



exception DuplicateProviderException: 
com: :sun: :star: :uno: : Exception 

{ 

}; 



[0401] Interface XContentldentifierFactory takes a uniform resource identifier, e.g., a URL, for content and returns 
a content identifier for that content. Interface XContentldentifierFactory inherits from Interface XInterface, 



TABLE 29.: Interface XContentldentifierFactory 



interface XContentldentifierFactory: 
com: :sun: : star: :uno: :XInterface 

I 

com: :sun: rstar: :ucb: :XContentIdentif ier 

createContentldentif ier ( [in] string Contentid ); 



[0402] Interface XContentldentifter also inherits from interface XInterface. Method getContentldentifier of interface 
XContentldentifier returns a content identifier string that is a valid unifomri resource identifier. See for example, RFC 
2396, which is incorporated herein by reference as an example of the level of skill with respect to uniform resource 
identifiers. If a content provider Implements some existent URI scheme, e.g.. a content provider offering access to a 
file system would implement the file' scheme, and a content provider offering access to IMAP servers would implement 
the 'imap' scheme, the content identifier strings should use that scheme. If on the other hand a content provider offers 
access to content for which no appropriate URI scheme exists, a vendor-specific URL scheme starting with 'vnd.' must 
be created. The URL scheme associated with a content provider may be retrieved using method getContentProvider- 
Scheme, This string Is calculated from the content identifier string and must be lower-case. In one embodiment. The 
string retumed is the URL scheme the content provider is registered for. For example, a provider for FTP contents uses 
ftp-URL's as content identifiers. The content provider scheme, sometimes called URL scheme, for all contents provided 
by that provider is 'ftp". 
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TABLE 30.: Interface XContent Identifier 



10 



interface XContentldentifier : 

com: :sun: :star: :uno: :XInterface 

{ 

string getContentldentif ier ( ) ; 
string getContentProviderScheme ( ) ; 
}; 
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[0403] Interface XContentCreator is a creator for new (persistent) contents, like file system folders ). The following 
is a pseudo code example of creation of a new (persistent) content: 

newObject = creator.createNewContent( ... ) 

initialize the new object ( i.e. 
newObject. Propertyl = ... ) 

[0404] The new content executes the command insert that commits the data and makes the new content persistent 
Interface XContentCreator inherits from interface XInterface. Method queryCreatableContentslnfo returns a list with 
infomiation about the creatable contents. Method createNewContent creates new content of a given type. 
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TABLE 31, 



Interface XContentCreator 



interface XContentCreator: 

com: rsun: :star : runo: : XInterface 

{ 

sequence<com: : sun: : star: :ucb: rContentInf o> 

queryCreatableContentslnfo ( ) ; 
com: :sun: rstar: :ucb: : XContent createNewContent ( 
[in] com: : sun :: star :: ucb :: Contentlnfo Info ); 
}; 



[0405] Structure Contentlnfo is defined in TABLE 32. This is a structure for information about contents. Type is a 
50 type identifier string for the content, i.e., a MIME type. Attributes is any flags providing additional information about the 
implementation of interface XContentCreator 
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TABLE 32, 



Structure Contentlnfo 



struct Contentlnfo 
I 

string Type; 
long Attributes; 



GETTING CONTENT FROM A PROVIDER SYSTEM. 

[0406] Content Is provided by implementing the Interfaces described above. In this example, the runtime environment 
provides a function gefG/oba/Se/v/ceManager that can be used in Instantiate service UniversalContentBroker. Next 
object identifierFactory Implements interface XContentldentifierFactory, and object provider Implements Interface 
XContentProvider. As described above, a content identifier Is obtained by giving a URL to the content to method ere- 
ateContentfdentifierol Interface XContentldentifierFactory. A content object is created by passing the content identifier 
to method queryContent of interface XContentProvider. 



TABLE 33.: Example of Creating Content using UCB 

interfaces • 



globalManager := getGlobalServiceManager ( ) 
ucb : = 

globalManager . createlnstance ("com. sun. star .ucb. Uni 

versalContentBroker" ) 
identifierFactory : = 

ucb . querylnterf ace ( "com, sun . star . ucb . XContentldent 

if ierFactory") 
provider := 

ucb . querylnterf ace ( "com. sun . star . ucb. XContentProvi 
■ . der") 

identifier := identifierFactory, 

createContentldentif ier ("ftp: //rimmer/pub") 
content := provider .queryContent (identifier) 



Content objects. 

[0407] A content provider provides content objects that Implement a set of interfaces that define: the type of content; 
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notification of when content changes state; how content may be created from this content; what children this content 
has; what commands may be performed on the content; and what properties may be obtained. Note that not alt aspects 
of the above may be defined. It will obviously depend on the type of content created. 

[0408] Interface XContent specifies a content with a type and an identifier, which is able to manage listeners for 
special content events. Method getldentifier returns an identifier for the content, while method getContentType returns 
a content type string, i.e., a MIME type. In addition, clients of the content may add themselves as listeners on the 
content using method addContentEvBntUstener and can remove themselves as listeners by using method remove- 
ContentEventUstener. 



TABLE 34- 



Interface XCONTENT 



interface XContent: com: :sun: :star: :uno; :XInterface 
I 

com: :sun: :star: :ucb: : XContentldentif ier 

getldentifier { ) ; 
string getContentType () ; 

[oneway] void addContentEventListener { [in] 

com: :sun: ; star: :ucb: :XContentEventListener 
Listener ) ; 

[oneway] void removeContentEventListener ( [in] 
com: :sun: : star: :ucb: zXContentEventListener 
Listener ) ; 

\; 



[0409] When action on content is performed, registered clients are notified by the content calling interface XConten- 
tEventUstener thai inherits from interface XEventUstener. Notification occurs when content is inserted, removed, de- 
leted, changes, or matches search criteria. 

[0410] Content is inserted, for example, when a child is inserted into the content. For example, if a directory folder 
is opened its content may be inserted asynchronously Into the folder. A client responsible for the display of this content 
may then update its view according to the new content. 

[0411] When content is removed but not deleted, a removed event is broadcast. An example of this may occur if 
child content is moved to a different parent. 

[0412] A deleted event is broadcast to all listeners when the content is physically destroyed. The content no longer 
persists. 

[0413] An exchanged event is broadcast to all listeners when the content has changed its identity. For example if a 
directory folder has changed its name. 

[041 4] Method contentEvent is called with structure ContentEvent whenever content wishes to notify the registered 
listeners for the content of a change or changes. 
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TABLE 35.: Interface XContentEventListener 



10 



15 



interface XContentEventListener: 

com: : sun: :star: :lang: :XEventListener 

{ 

void contentEvent ( [inl ContentEvent evt ); 
}; 
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[0415] One embodiment of structure ContentEvent that inherits from structure EventObject is presented below. An 
action member is filled as follows: 



ContentAction::INSERTED 


- The inserted child 


content. 




ContentAction-REMOVED 


- The removed child 


content. 




ContentActlon::DELETED 


- The deleted content. 


ContentAction::EXCHANGED 


- The exchanged content. 



[0416] A content identifier member must be filled according to the action field, e.g., the id of the parent into which a 
30 child was inserted. This member must be filled as follows: 





ContentAction : : 1 NSERTED 


- Id of the parent of the 




inserted content. 






ContentAction::REMOVED 


• Id of the parent of the 


35 


removed content. 






ContentAction::DELETED 


- Id of the deleted 




content. 






ContentAction::EXCHANGED 


- Previous(!) id of the 


40 


exchanged content. 
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TABLE 36.: Structure ContentEvent 



10 
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Struct ContentEvent: 
com: :sun: : star: :lang: rEventObject 
{ 

long Action; 
XContent Content; 
XContent Identifier Id; 
}; 
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[041 7J A content object that has children can implement interface XtndexAccess that inherits from interface XEIe- 
mentAccess. These interfaces define a general set of APIs to access collections. Interface XIndexAccess may be used 
for content to return children that are also content. The type any returned from method getBylndex might be cast 
according to Interface XContent if it is valid to do so. Thereby a directory or folder content may return its children in 
this way. 

[041 8] interface XIndexAccess provides access to the elements of a collection through an index. This interface should 
only be used if the data structure, itself, is indexed. Method getCount returns the number of elements in the content 
object. Method getBylndex returns the element at the spedfied index. This method throws exception IndexOutOfBound- 
sException if the Index is not valid; or exception WrappedTargetException if the implementation has internal reasons 
for exceptions. 
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TABLE 37. 



Interface XIndexAccess 
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interface XIndexAccess: 

com: : sun : : star : : container : : XElementAccess 

{ 

[const] long getCount (); 

[const] any getBylndex ( [in] long Index ) 
raises { 

com: :sun: :star: :lang: : IndexOutOf BoundsException, 
com: :sun: :star: :lang: : WrappedTargetException ) ; 

}; 



55 [04191 Interface XElementAccess is the base interface of all collection interfaces and inherits from interface Xlnter- 
face. Method getElementType returns the type of the elements. A void return means that it is a multi-type container 
and cannot determine the exact types with this interface. Method hasEfements returns true if the content object contain 
elements, and othenwise false. Interface XldlClass and the other interfaces used by it are included at the end of the 
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detailed description for completeness. 



TABLE 38.: Interface XElement Access 



interface XElementAccess : 

com: :sun: :star: :uno: rXInterface 

{ 

[const] TYPE_XIDLCLASS getElementType ( ) ; 

[const] boolean hasElements ( ) ; 
}; 



[0420] Exception IndexOutOfBounds is thrown to indicate that a container has been accessed with an illegal index. 
The index is either negative or greater than or equal to the count of the elements. 



TABLE 39.: Exception IndexOutOfBounds 



exception IndexOutOf BoundsException : 
com: : sun : : star : : uno : : Exception 



[0421] Exception WrappedTargetException is a checked exception that wraps an exception thrown by tiie original 
target. Normally this exception is declared for generic methods. 

TABLE 40.: Exception Pi^rapped Target Ex caption 



exception WrappedTargetException: 

com: :sun: :star: :uno: : Exception 

{ 

any TargetException; 



[0422] In this embodiment, two Interfaces are used to execute commands on content objects. Interface XCommand- 
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TaskProcessor ls used if asynchronous operations are desired, while interface XCommandProcessor is simpler and 
does not support asynchronous operations. 

[0423] Interface XCommandSaskProcessor creates tasks for commands to be executed by the implementation of 
this interface and provides access to infomnation about supported commands. This interface inherits from interface 
Xlnterface. Method createCommandTask creates a task for executing a command. Input parameter TheCommand is 
the command to execute. Input parameter ResultAcceptor is the object used to notify/set partial/ whole result set. This 
may be an empty interface, if the task does not produce results. Parameter Environment is the execution environment. 
This method returns the command task. Method getCommandsfnfo returns an interface providing access to information 
about the commands supported by the implementation of this interface. 



TABLE 41.: Interface XCoimandTaskProcessor 



interface XCommandTaskProcessor : 

com: :sun: rstar: :uno: :XInterface 

( 

com: :sun: :star: :ucb: :XCommandTask: createCommandTask ( 

[in] com: : sun: : star :: ucb: : Command TheCommand^ [in] 
com: ;sun: :star: :ucb: :XResultAcceptor 
ResultAcceptor, ( in] 

com: :sun: :star; :ucb: :XContentTaskEnvironment 
Environment ) ; 
com: :sun: rstar: :ucb: :XCommandInfo getCommandsInf o ( ) ; 
}; 



[0424] Interface XCommandTask defines a task for executing commands. Interface XCommandTask inherits from 
interface XContentTask. Method getCommand returns the command to execute by the task. 
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TABLE 42. 



Interface XCommandTask 
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interface XCommandTask: 

com: ;sun: :star: :ucb: :XContentTask 

{ 

com: :sun: :star: :ucb: : Command getCommand () ; 
}; 



55 [042 5] I nterface XContentTask defines a task, which can be processed synchronously or asynchronously in a specific 
execution environment. This interface inherits from interface Xlnterface, Method start starts asynchronous execution 
of a task. In general, the task will is not completed on return of this method. If the task is performed asynchronously, 
event notification occurs through mXeriaceXContentTaskEnvironment. Method execute executes a task synchronously 
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The task always is completed on return of this method. Method abort ends execution of a task. Method getStatus 
returns the current status of a task. Method getEnvironment returns the environment of the task. Interface XContentTask 
is a super interface that is used by both interface XCommandTask and interface XPmpertyTask, 

TABLE 43.: Interface XContentTask 



interface XContentTask: 

com: : sun: rstar: :uno: :XInterface 

{ 

[oneway] void start (); 
void execute () 

raises! com: :sun: : star; :uno::Exception ); 
[oneway] void abort () ; 
com: : sun: : star: :ucb: : ContentTaskStatus getStatus ( ) ; 
com: : sun: : star: :ucb: : XContentTaskEnvironment 
getEnvironment () ; 

}; . 



[0426] Enumeration ContentTaskStatus contains the possible task states. State CREATED means the task was just 
created and is waiting to be processed. This is the initial task state. No event is send to a task client to indicate this 
state (there is no change). State RUNNING means the task processing was just started. State DONE means the task 
was finished successfully. State ABORTED means the task was finished unsuccessfully, I.e. termination from "outside", 
or due to an unrecoverable error 



TABLE 44.: Enumeration ContentTaskStatus 



enum ContentTaskStatus 
{ 

CREATED, 
RUNNING, 
DONE, 
ABORTED 

); 



[0427] Interface XContentTaskEnvironment defines the execution environment of a task. This interface inherits from 
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interface XInterlace. Method getOient returns the task's client Method getlntemctionHandler retdms the task's Inter- 
action handler Method getProgmssHandler returns the task's progress handler. Interface XContentTaskEnvironment 
provides a context for asynchronous tasks (commands and property operations) to handle errors and notify the listeners 
when tasks have changed status. An implementation of interface XContentTaskEnvironment also Includes the ability 
to set a reference to interface XContentTaskClient, which is used provide task status feedback. 



TABLE 45.: Interface XContentTaskEnvironment 



interface XContentTaskEnvironment : 

com: : sun: : star: runo: rXInterf ace 
com: :sun: :star: :ucb: : XContentTaskClient getClient {) ; 
com: :sun: :star: :task: : XlnteractionHandler 

getlnteractionHandler 0 ; 
com: :sun: :star: :ucb: :XProgressHanciler 

getProgressHandler ( ) ; 

}; 



[0428] Interface XContentTaskClient defines a client for content tasks; Interface XContentTaskClient inherits from 
interface XEventUstenen Method contentEventTask Is called to notify listeners of a status change of a content task via 
a structure ContentTaskEvent, 



TABLE 46.: INTERFACE XContentTaskClient 



interface XContentTaskClient: 

com: :sun: :star: :lang: :XEventListener 

{ 

void contentTaskEvent ( [in] 

com: : sun: : star : :ucb: :ContentTaskEvent Event ); 

}; 



[0429] Structure ContentTaskEvent inherits from structure EventObject. The structure contains the old status and 
the new status. 
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Structure ContentTaskEvent 



struct ContentTaskEvent : 

com: : sun: : star: : lang: : EventObject 

{ 

com: :sun: :star: rucb: : ContentTaskStatus OldStatus; 
com: :sun: rstar: :ucb: : ContentTaskStatus NewStatus; 

}; 



[0430] Interface XlnteractionHandlerh3n6\es an interaction request. This interface inherits from interface X/nfe/fece. 
TABLE 48.: Interface XlnteractlonHandler 



interface XlnteractlonHandler: 

com: :sun:.: star: :uno: zXInterface 

{ 

void handle ( [in] 

com: :sun: :star: :task: : XInteractionRequest Request 
) ; 

}; 



[0431] Interface XInkeractlon Request gets information about the request itself. 
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TABLE 4 9. : Interface XInteractionRequest 



10 



15 



20 



interface XInteractionRequest: 

com: :sun: :star: :uno: :XInterface 

{ 

[const] any getRequest () ; 
[const] 

sequence<com: :sun: :star: :task: :XInteractionContinu 
ation> getContinuations ( ) ; 

1; 



25 



[0432] Interface XInteractionContinuation inherits from interface XInterface. Method select selects a way of contin- 
uing from an interaction request given a choice of various 'mteriaces XInteractionContinuation 



TABLE 50. : Interface XInteractionContinuation 



30 



35 



40 



45 



interface XInteractionContinuation: 
com: : sun: : star: :uno: :XInterf ace 

{ 

void select ( ) ; 
}; 



[0433] Interface XPAogressHancf/er handles a tasks notification that the task has made some progress. Method pusti 
notifies the handler that the task has started some new activity, possibly a sut>-activity of another activity already making 
progress. Therefore, these notifications behave in a stack-like manner. Method update notifies the handler that the 
task's current activity is making progress Method pop notifies the handler that the task has finished its current activity. 
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INTERFACE XProgressHandler 



interface XProgressHandler: 

com: :sun: :star: :uno: :XInterface 

{ 

void push ([in] any Status); 
void update {[in] any Status); 
void pop ( ) ; 
} ; 



20 [0434] Structure Command contains a command. Name contains the name of the command. Handle contains an 
implementation-specrfic handle for the command. Handle may be -1 if the implementation has no handle. Argument 
contains the argument of the command. 

TABLE 52 . : Structure Command 



struct Command 
{ 

string Name; 
long Handle; 
any Argument; 
}; 



40 , 

[0435] Interface XResultAcceptor defines an acceptor for results; This interface offers two communication channels 
for the propagation of the results. The first channel is used to propagate results as soon as the results are available. 
The second channel is used to supply the complete result set once. Interface XResultAcceptor inherits from interface 
XEventUstener. Method usePartialResultChannel indicates what channel to use for the propagation of results. If the 

45 implementation of this interface is interested in getting any partial result as soon as it is produced by the result supplier, 
this method should return TRUE. In this case, the complete result set will hot be supplied by the supplier. If the Imple- 
mentation is only Interested in getting the complete result of the operation this method should return FALSE. The 
supplier will not propagate any partial results in this case. Method partialResutts is called to supply a partial result, i. 
e., a single child just processed while populating a container): Method completeResult isca\\e6 to supply the complete 

50 result. i.e., a sequence containing all children of a container . 
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INTERFACE XResultAcceptor 



10 



interface XResultAcceptor ; 

com: :sun: :star: :lang: :XEventListener 

{ 

boolean usePart ialResultChannel ( ) ; 
void partialResult ( [in] any Result ); 
void completeResult ( [in] any Result ); 

); . 



20 



25 



[0436] Interface XCommandlnfo provides access to information at)out executable commands. Method getCom- 
mands returns a sequence of all commands supported by the object Method gelCommandlnfoByName returns the 
command with the specified name from the object. This method throws exception UnsupportedCommandException if 
the command name is unknown to the object. Method getCommandlnfoByhtandle returns the command with the spec- 
ified handle from the object and throws exception UnsupportedCommandException if the command handle is unknown 
to the object. Method hasCommandByName returns TRUE if a command with the specified name is supported, and 
othenvise FALSE is retumed. Method hasCommandByHandle returns TRUE if a command with the specified handle 
is supported, and othenwise FALSE is retumed. 



30 
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TABLE 54.: Interface XCommandlnfo 



interface XCommandlnfo: com: :sun: rstar: :uno: rXInterface 

{ 

[const] sequence<com: : sun: rstar: : ucb: rCommandInf o> 

getCommands ( ) ; 
[const] com: :sun: :star: :ucb: : Commandlnf o 

getCommandlnfoByName ( [in] string Name ) 
raises ( 

com: :sun: :star: :ucb: : UnsupportedCommandException 
); 

[const] com: :sun: :star: :ucb: : Commandlnf o 

getCommandInf oByHandle ( [in] long Handle ) 
raises ( 

com: :sun: :star: :ucb: : UnsupportedCommandException 
) ; 

[const] boolean hasCommandByName ( [in] string Name ); 
[const] boolean hasCommandByHandle ( [in] long Handle ); 
}; 



structure Commandlnfo describes a command. Name contains the name of the command. Handle contains an imple- 
mentation-specific handle for the command. Handle may be -1 if the Implementation has no handle. ArgType contains 
the type of argument of the command. 

TABLE 55.: STRUCTURE Commandlnfo 



struct Commandlnfo 
{ 

string Name; 
long Handle; 
TYPE_XIDLCLASS ArgType; 
1; 
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[0437] Exception UnsupportedCommand is thrown to indicate that the command Is not known by the implementation 
of an interface. 

TABLE 56.: Exception UnsupportedCommand 



except ion UnsupportedCommandExcept ion : 
com: : sun: : star: :uno: : Exception 

{ 

}; 



[0438 J The above interfaces are associated with interface XCommandTaskProcessor, Interface XCommandProces- 
sor defines a processor for synchronous commands, which are executed in a specific execution environment. 
Interface XCommandProcessor inherits from interface X/nferfece. Method createCommandldentifier creates a unique 
Identifier for a command, which can be used to abort the execution of the command associated with that identifier. 
Note that it Is generally not necessary to obtain a new id for each command, because commands are executed syn- 
chronously So the Id for a command is valid again after a command previously associated with this Id has finished. 
Preferably, only one identifier per thread Is obtained and that Identifier Is assigned to every command executed by that 
thread. Method execute executes a command. Parameter aCommand is the command to execute. Parameter Com- 
mandid Is a unique id for the command. This identifier was obtained by calling method createCommandldentifier A 
value of zero can be used, if the command never shall be aborted. Parameter Enwron/nenf is the execution environment. 
Method execute returns the result according to the specification of the command. Exception CommandAbortedExcep- 
Hon is thrown to indicate that the execution of the command was aborted. Method abort ends execution of the command 
associated with the given Id. Parameter Commandld was defined above. 

TABLE 57.: Interface XCommandProcessor 



interface XCommandProcessor : 

com: : sun: : star: :uno: :Xlnterf ace 

{ . 

long createCommandldentif ier () ; 

any execute! [in] Command aCommand, [in] long 

Commandld, [in] XCommandEnvironment Environment ) 
raises ( com: : sun: : star: ;uno: : Exception, 

CommandAbortedException ) ; 
[oneway] void abort ( [in] long Commandld ) ; 
}; 



[0439] Interface XComma/idEnwronmenf defines the environment of a command. Interface XCommanrf&wronmenf 
inherits fi-om Interface XInterface. Method getlnteractionHandier returns the command's interaction handler. Method 
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getProgressHandler returns the command's progress handler. 

TABLE 58.: Interface XCommandEnvironment 



interface XCommandEnvironment 



com: : sun: : star: :uno: :XInterface 



com: 



com: 



: sun: : star: : task: cXInteractionHandler 

getlnteractionHandler 0 ; 
; sun: : star: : ucb: :XProgressHandler 

getProgressHandler ( ) ; 



}; 



[0440] The above interfaces present alternative ways to process commands associated with content. Other actions 
associated with content concerns properties associated with the content. 

[0441] The querying of property types is perfomned through interface XMuttiPropertySet that was described above 
and is incorporated herein by reference. Thus, a content object also must implement this Interface. 
[0442] Interface XPmpertyTaskProcessor inherits from interface Xlnterface, This Interface encapsulates behavior 
similar to interface XCommandTaskProcessor. Interface XPropertyTaskProcessor creates tasks for getting and for 
setting properties of the implementation of this interface and provides access to information about the supported prop- 
erties. Method createPropertyTask creates a task for handling properties. Input parameter Type is the type of the task 
( GET or SET ). Input Parameter Properties Is the properties to get or set by the task. For a Get-task, only the member 
Name and/or Handle must be filled. For a Set-task, both Name and/or Handle and Value member must be filled. If a 
handle is given, the handle is prefen-ed over the property name. Input parameter Environment is the execution envi- 
ronment. Input parameter PropertyListerier is a listener for changes of properties processed by the task. Method crer 
afePrope/iy7as/f returns the property task. Method getPropertylnfo returns interface XPrope/tySef/n/b interface, which 
describes all properties of the object to which this interfaces belongs. NULL is returned if the object cannot or will not 
provide information about the properties. Method 

addPropertiesChangeUstenera66s an interface XPropertiesChangeListenerio the specified properties with the spec- 
ified names. Method 

removePropertiesChangeUstenerremoves an Interface XPropertiesChangeUsteneriiom the listener list for the spec- 
ified properties with the specified names. An empty sequence means all properties. 



TABLE 59. : 



Interface XPropertyTaskProcessor 



interface 



XPropertyTaskProcessor: 
sun: :star: :uno: :XInterface 



com: 



com: : sun : 



[in] 
[in] 



star: :ucb: : XPropertyTasJc createPropertyTask { 
com: : sun :: star: :ucb: : Proper tyTaskType Type, 
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sequence<com: : sun : : star : : beans : : PropertyValue> 
Properties, [in] 

com: :sun: rstar: :ucb: :XContentTaskEnvironment 

Environment ) ; 
com: ;sun: rstar: : beans: :XPropertySetInfo 

getPropertySetlnfo ( ) ; 
[oneway] void addPropertiesChangeListener ( [in] 

sequence<string> PropertyNames, [in] 

com: :sun: :star: :beans: :XPropertiesChangeListener 

Listener ) ; 

[oneway] void removePropertiesChangeListener ( [in] 
sequence<string> PropertyNames, [in] 
com: :sun: rstar: rbeans: :XPropertiesChangeListener 
Listener ) ; 

); 



[0443] InterfaceXProperfyTas/f definesa taskfor getting or setting properties. Interface XPropertyTasIc inherits from 
interface XContentTask that was described above. Method getType returns whether the task Is for getting or for setting 
properties. Method getProperties returns the properties to be processed by the task. The status of the properties can 
be obtained at anytime by checking member ProcessingState of each PropertyValue Info. 

TABLE 60.: INTERFACE XPropertyTask 



interface XPropertyTask: 

com: :sun: :star: :ucb: : XContentTask 

{ 

com: : sun: : star: :ucb: : PropertyTaskType getType ( ) ; 
sequence<com: :sun: rstar: :ucb: : PropertyValueInf o> 
getProperties ( ) ; 



1; 



[0444] Enumeration PropertyTaskType defines the possible types for a property task. 
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TABLE 61.: Enumeration PropertyTaskType 
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enum PropertyTaskType 
{ 

GET, 
SET 

}; 



[0445] Stmcture PropertyVatuetnfb contains value and state of a property to be processed. Structure ProperteryVal- 
uelnfo inherits fomi structure PropertyValue. 



TABLE 62.: STRUCTURE PropertyValuelnfo 
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Struct PropertyValuelnfo: 

com: : sun : : star : : beans : : PropertyValue 

{ 

com: : sun: : star: :ucb: : PropertyValueState ValueState; 
}; 



[0446] Enumeration PropertyValueState defines the possible states of a property to be processed by the task. State 
UNPROCESSED means the property value is to be processed by the task. State PROCESSED means the value was 
set or it was obtained by the task. In the last case the value is stored in member Value of structure PropertyValuelnfo, 
State INVALID_NAME means the given property name/handle is invalid. State INVALID_TYPE means the given prop- 
erty type is invalid. 



50 



55 



74 



EP 1 126 681 A2 

TABLE 65.: STRUCTURE Property 



struct Property 
{ 

string Name; 
long Handle; 
TYPE_XIDLCLASS Type; 
short Attributes; 
■}; 



[0449] Exception UnknownPropertyException is thrown to indicate that the property is unknown to the implementa- 
tion. 

TABLE 66. : EXCEPTION UnknownPropertyException 



exception UnknownPropertyException: 
com: : sun; :star : :uno: : Exception 

{ 

}; 



[0450] InterfaceXProperf/esC/iangeL/sfenerreceives events, which getfired whenever a bound property is changed. 
I nterfaceXPrope/t/esC/ja/jgeL/sfener inherits from interface XEvenfUsfener. Method propertiesChange 'is called when 
bound properties are changed. Input parameter aEvent contains a sequence of Properties Change Event objects that 
describe the event source and the properties that have changed. 
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TABLE 63.: Enumeration PropertyValueState 



enum PropertyValueState 
{ 

UNPROCESSED, 
PROCESSED, 
INVALID_NAME, 
INVALID_TYPE 

}; 



20 [0447] Structure PropertyValue specifies a property value. Name specifies the name of the property. The name is 
unique with a sequence of property values. Handle contains an implementation-specific handle for the property. The 
handle may be -1 if the implementation has no handle. Value contains the value of the property or void if no value is 
available. State determines if the value comes from the object Itself or from a default and if the value cannot be deter- 
mined exactly. 

25 ^ 

TABLE 64.: STRUCTURE PropertyValue 



struct PropertyValue 
( 

string Name; 
long Handle; 
any Value; 

40 

com: : sun: :star: :beans: : PropertyState State; 
}; 



[0448] Structure Property describes a property of the content. There are three types of properties: bound propertes; 
constrained properties; and free properties. Name specifies the name of the property. The name is unique within an 
50 XPropertySet. Handle contains an implementation-specific handle for the property. The handle may be -1 if the imple- 
mentation has no handle. Type contains an object that identifies the declared type for the property. If the property has 
multiple types or the type is not known but not any, void must be returned. Field attributes may contain zero or more 
constants of the PropertyAttribute constants group. See constants PropertyAttribute above. 



75 



EP 1 126 681 A2 

TABLE 67.: INTERFACE XPropertiesChangeListener 



interface XPropertiesChangeListener: 

com: :sun: :star: :lang: : XEventListener 

{ 

void propertiesChange ( [in] 

sequence<com: : sun: : star : : beans : : PropertyChangeEve 
nt> evt ) ; 

}; 



[0451] Structure PropertyChangeEvent is delivered whenever a •"bound" or "constrained" property is changed, A 
PropertyChangeEvent object is sent as an argument to the methods of inieriace XPropertyChangeListener Nomnally, 
such events contain the name and the old and new value of the changed property. Void values may be provided for 
the old and the new values if their true values are not known. 

TABLE 68.: STRUCTURE PropertyChangeEvent 



struct PropertyChangeEvent : 

com: : sun: : star : : lang: : EventObject 

{ 

string PropertyName; 
boolean Further; 
long PropertyHandle; 
any OldValue; 
any NewValue; 
); 



[0452] As described above, a content object that creates content implements interface XContentCreator. This inter- 
face defines what type of content may be created via method queryCreatabieContents/nfb. This interface returns a 
stmcture, which contains the MIME types of content that may be created. New content is created by calling method 
createNewContent with the appropriate Contentlnfb, i.e., a supported MIME type. This method does not persist the 
content since what has been created has not been initialized. Initialization may result in property and command oper- 
ations on the new content. When the content has been initialized, the content can be inserted into the parent Figure 
20 is a sequence diagram that illustrates the asynchronous operation of a command on a file system folder, in this 
example folder adapter object 505 implements interface XContentTaskEnvimnment, and issues a call to method ere- 
ateCommandTask of a folder object that implements interface XCommandTaskProcesson 

[0453] In response to the call to method createCommandTask, a call to method create (Fig. 20) in interface XCom- 
mandTask of an opentask object is issued. Interface XCommandTask issues a call to method getClient of interface 
XContentTaskEnvimnment When the task is returned to interface XContentTaskEnvimnment, an interface XContent- 
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TaskClient is created for the task and then method start is called in interface XCommandTask. Notice that the method 
returns before execution is completed. 

[0454] At a later time. Interface XCommandTask executes the task by making systems calls to the operating system. 
Also, the task status is returned to interface XCon/e/jf7as/fC//e/7f. When the task is done, a done event is sent to interface 
XContentTaskClient that calls method commandready in interface XContentTaskEnvimnment to indicate that the task 
is done. Notice that the folder adapter object was not required to remain active while the task was being executed. 
[0455] The following table is another pseudo-code example of the use of the interfaces described above. In this 
example, UCB 11 3 is used to open a file folder and to add a new file In the file folder. As described above, a runtime 
function getGlobalServiceManager ls used to create an instance of UCB 113 that implements service UniversalCon- 
fenfSro/cer. As shown in Figure 21, a file system registers with UCB 113 as a universal content provider 21 31 for protocol 
"file" that was sometimes refen-ed to as a URL scheme. As illustrated in Figure 21, universal content provider 2131 
uses interface XContentProviderManager, which was described above, to register with UCB 113 and to be place in 
provider registry 2101. 

[0456] A client of UCB 113, which as described above can be an application/service in remote applications 310. a 
folder adapter 505 of Figure 5, or a JAVA bean of Figure 8, creates an identifier factory that implements interface 
XContentldentifierFactory. The client creates a provider object that implements interface XContentProvider, and then 
obtains an identifier for a folder on the file system by passing a URL to the folder to method createContentldentifer of 
interface XContentldentifierFactory. To open the file system folder, the client, as illustrated in Figure 21 issues a call 
to method queryContent to interface XContentProvider o1 the provider object. 

[0457] Next, to create a file as new UCB content, a content creator object is defined that implements interface XCon- 
tentCreator Method createNewContent is called in the content creator object with content type of text/html to create 
object newfileContent. Properties of the new file are initialized, and then property task processor is created that imple- 
ments interface XPropertyTaskProcessor A property task is obtained by a call to method createPropertyTask (See 
Fig. 21 and following Table) and then executed to assign the properties to object newfileContent. Next, the file with the 
properties Is inserted in the parent folder using interface XCommandProcessor. 
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TABLE 69.; Example of Using UCB. 



// opening a file system folder 
globalManager := getGlobalServiceManager ( ) 

ucb : = 

globalManager . createlnstance ( "com. sun . star . ucb . Uni 
versalContentBroker " ) 
identif ierFactory := 

ucb.querylnterface ("com. sun. star .ucb. XContentldent 

if ierFactory") 
provider 

ucb.querylnterface ("com. sun. star. ucb. XContentProvi 
der") 

identifier := 

identif ierFactory .createContentldentifier ("file: / / 

/home/usr/userl" ) 
folderContent : = provider . queryContent (identifier) 

// create a file as new UCB content 
contentCreator := folderContent. 

querylnterf ace ( "com . sun . star . ucb . XContentCreator " ) 
contentlnfo.Type := "text/html" 
newFileContent :- contentQreator . 

createNewContent (contentinf o) 

// initialize the new content with one attribute 
properties := new PropertyValue [1] 
properties [0] .Name := "Title" 
properties [0] .Value := "test.html" 
propertyTaskProc := newFileContent. 

queryInterface("com. sun. star .XPropertyTaskProcesso 

r") 

propertyTask := 

propertyTaskProc. createPropertyTask(PropertyTaskTy 
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pe.SET, properties, 0) 
propertyTask. execute () 

// insert the file into the parent folder 
commandProc := 

newFileContent . querylnterf ace ("com. sun . star . ucb .XC 

ommandProcessor" ) 
command. Name := "Insert" 

id = commandProc. createCommandldent if ier ( ) 

commandProc. execute (id, command, 0) 

// on successful return the changes are stored 



OBTAINING CHILDREN FROM CONTENT. 

[0458] From the content object, a reference to interface X/ndexAccess is obtained. The number of children is obtained 
from method getCount Each child is obtained via method getBylndex, which is of type Any. If type Any can be cast to 
a reference to a pointer to interface XContent, an XCcntent reference is obtained. The XContentldentifier reference is 
obtained from interface XConfenf. From this the scheme is printed out. From XContent the MIME type is printed out. 
See the following table. 

TABLE 70 . : 

Reference< XIndexAccess > xldx( 

Reference< XIndexAccess >:: query [ iii__xContent 

) ); 

sal_ulnt32 nCount = xldx->getCount() ; 
if ( nCount ) 

{ 
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print ( "Children:" ) ; 

for ( sal_ulnt32 n = 0; n < nCount; ++n ) 
{ 

Any aChild = xldx->ge tBy Index ( n ); 
if ( aChild. getVaiueTypeO == 
getCppuTypei (const Reference< XContent 



>*)NULL ) ) 



pContent = 



{ 

const Reference< XContent >* 



SAL_STATIC_CAST( const 
Reference< XContent >*, 

aChild. get Value {) ) ; 
Reference< XContent > xContent( 



*pContent ) 
xld( 



Reference< XContentldentif ier > 



xContent->get Identifier 0 ) ; 
WString aText( "\t" ); 
aText += xld- 
>getContentIdenti fieri) .getStrO ; 

aText += " - 
aText += xContent- 

>getContentType{) ; 

print ( aText ) ; 

} 

} 

} 

EXECUTING TASKS ON CONTENT OBJECTS. 

[0459] Once an XContent reference is obtained for a content object, it is possible, if supported, to execute tasks on 
the content to send commands or get and set values of properties. 

Querying commands. 

[0460] From the content object, a reference to interface XCommandProcessor is obtained. If the reference is valid, 
a reference to interface XCo/nmand/nfo is obtained and from this the sequence of possible commands. The command 
names are then printed out. 
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Executing commands. 

[0461 ] A reference to interface XCommandTask is created from the reference to interface XCommandTaskProcessor 
with a given Command and reference to the XContentTaskEnvinonment. If the task is valid, the task is executed syn- 
5 chronously via method execute. The resultant object of type any is obtained via method getResuft. See the above 
examples. 

Querying properties. 

10 [0462] From the XContent reference the XPropertyTaskProcessor reference Is obtained. If the task is valid, then the 
reference to interface XPropertySetlnfo is obtained via the method getPropertySetlnfo. The sequence of property 
names is then obtained from method getProperties. The property names are then printed out. 

Get value of a property. 

15 

[0463] From the XPropertyTaskProcessor reference, an XPropertyTask reference is created via the method create- 
PropertyTask with a sequence of properties and a reference to Interface XContentTaskEnvironment. If the task Is valid, 
the property is obtained by calling method execute. Thus, the property is obtained synchronously. The sequence of 
values is then obtained from method getProperties method. The value of the first property is then obtained in an any. 

20 

Hierarchy Service 

[0464] As described above, UCB 1 1 3 aggregates the content from different transport protocols and different storage 
systems in a homogeneous API. As the UCB aggregates content on API level, hierarchy service 335 extend the concept 
25 of hierarchal relations to virtual hierarchy of UCB contents (Figure 2D). Hierarchy service 335 Is a UCP, which provides 
three kinds. of contents: a root folder, virtual folders and links to other UCB contents. This means a client can use 
hierarchy sennce 335 to store a user defined 'view* on several UCB contents. The View' is defined by the hierarchical 
relation t>etween virtual folders and links to other UCB contents. These relations are stored In user configuration service, 
as described above. 

30 [0465] Hierarchy senrice 335 provides three different types of contents: a HCP Link, a HCP Folder and a HCP Root 
Folder. A HCP link 2202A is a content, which points to another UCB content 2203A. A HCP link 2202A is always 
contained in a HCP Folder 2200. A HCP Link has no children. A HCP Folder, e.g., folders 2200, 2201 A to 2201 C, is 
a container for other HCP Folders and HCP Links. There is at most one instance of a HCP Root Folder 2200 at a time. 
All other HCP contents are children of this folder. The HCP Root Folder can contain HCP Folders and HCP Links. In 

35 one embodiment, root folder 2200 has a URL such as vnd.sun.starhier:/. 

[0466] HCP Folders 2201A to 2201C and HCP Root Folder 2200 implement the interface XContentCreator. HCP 
Links and HCP Folders support the command "insert". This means all HCP Folders and the HCP Root Folder as well 
can create new HCP Folders and HCP Links. 

[0467] To create a new child of a HCP Folder, the parent folder creates a new content by calling its method creat- 
40 eNewContent. The content type to use for new folders is application/vnd.sun.star.hier-folder. To create a new link, the 
type string application/vnd. sun. star. hier-iink is used. The URLs used here are illustrative only and are not intended to 
limit the invention to the specific example. 

[0466] To set a title at the new folder/link, the new child executes a command setProperty Values, which sets at least 
the property Title" to a non-empty value. Also, the child can set the property TargetURL as well at this time, but this 
<5 is not required. This property may also be set later. 

[0469] Next, the new child (not the parent ) executes the command "inserT. This commits the creation process. 

URL Scheme for HCP Contents 

50 [0470] Each HCP content has an identifier corresponding to the following scheme: 
vnd.sun.star.hier/<path> 
where <path> is a hierarchical path of the form 

<name>/<name>/.../<name> where <name> is a string encoded according to the URL conventions. 

55 Examples: 

[0471] vnd.sun.star.hier:/ ( The URL of the HCP Root Folder) vnd.sun.star.hieri/Bookmarks/ 
Sun%20Microssystems%20Home % 20 Page 
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vnd.sun.star.hler:/Workplace/Pi1nters 

[0472] The following table gives an overview of different HCP contents. 
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•) The "transfer" command only transfers HCP-contents to HCP folders. It does not handle contents with a URL scheme other then the HCP-URL- 
scheme. 



[0473] HCP 335 is transparent for the client program code, whether the UCB content is stored on the file system, 
retrieved via HTTP or just a virtual folder, provided by the users configuration. Transparent means, that the same client 
program code, which works on a UCB content from file system, works on UCB content from HCP and any other UCP, 
too. HCP 335 uses configuration server 336 as persistent storage for the virtual hierarchy. In one embodiment, the 
55 hierarch content provider 335 stores the relations between virtual folders and links also In XML. 

[0474] Interface XPropertiesChangeNotifier\T\c\u6es two methods. Method addProperkiesChangeListener adds an 
Interface XPropertiesChangeUstener io the specified properties with the specified names. Input parameter Property- 
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Names specifies the names of the properties. An empty sequence means "all properties". Input parameter Listener 
contains the listener for the property change events. Method removePropertiesChangeUstener removes an interface 
XPropertiesChangeLlstener from the list. 

TABLE 71. : Interface XPropertiesChangeNotifier 



interface XPropertiesChangeNotifier : 
com: : sun: :star : :uno: :XInterface 

{ 

[oneway] void addPropertiesChangeListener ( [in] 
sequence<string> PropertyNames, [ in] 
com: :sun: : star :: beans : :XPropertiesChangeListener 
Listener ) / 

[oneway] void removeProper.tiesChangeListener ( [in] 
sequence<string> Proper tyNames, [in] 
com: : sun : : star : : beans : : XPropert iesChangeListener 
Listener ) ; 

}; 



[04751 Interface XPropertyContainer includes methods to add a property and remove a property from a container 
Parameter Name specifies the name of the new property. Parameter Attributes specifies the attributes for the new 
property. Parameter DefaultValue specifies the default value for the new property. 

TABLE 72.: Interface XPropertyContainer 



interface XPropertyContainer: 

com: : sun : : star : : uno : :XInterface 

{ 

void addPropertyl [in] string Name, [in] short 
Attributes, [in] any DefaultValue ) 
raises ( 

com: :sun: :star: : beans; : PropertyExistException, 

com: :sun: :star: : beans: : IllegalTypeException, 

com: : sun : : star : : lang : : IllegalArgumentExcept ion ) ; 



84 



EP1 126 681 A2 



void removeProperty ( [in] string Name ) 
raises ( 

com: :sun: :star: : beans: : UnknownPropertyException, 
• com; : sun: : star: : beans: ; NotRemoveableException ) ; 

}; 



[0476] Interface XPropertySetlnfbChangeNotifier includes methods to add and remove listeners for property set in- 
formation change events. 

TABLE 73.: Interface XPropertySetlnfoChangeNotifier 



interface XPropertySetlnfoChangeNotifier : 
com: : sun: : star: :uno: :XInterface 

{ 

void addPropertySetInf oChangeListener { [in] 

XPropertySetlnfoChangeListener Listener ) ; 
void removePropertySetInf oChangeListener ( 
[in] XPropertySetlnfoChangeListener Listener ); 
); 



[04771 Interface XPropertySetlnfoChangeListener includes method propertySetlnfoChange that is called whenever 
changes of an Interface XPropertySettnfb is to be propagated. 

TABLE 74.: Interface XPropertySetlnfoChangeListener 



interface XPropertySetlnfoChangeListener : 
com: :sun: :star: :lang: : XEventListener 
{ void propertySetlnfoChange ( [in] 



PropertySetlnfoChangeEvent evt ) ; 
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TABLE 75.: Structure Proper ty Set In foChangeEvent 



struct PropertySetInf oChangeEvent : 

com: : sun: :star: : lang: lEventObject 

{ 

string Name; 
long Handle; 

/** contains the reason for the event. */ 

long Reason; 

); 



[0478] Interface XCommandlnfdChangeNotifier adds, i.e., registers listeners for CommandlnfoChangeEvents. 
TABLE 76. : Interface XCommandlnfoChangeNotifier 



interface XCommandlnfoChangeNotifier : 
com: : sun; :star : :uno; :XInterface 

{ 

void addCommandInf oChangeListener ( [in] 

XCommandInf oChangeListener Listener ) ; 

void removeCommandInf oChangeListener ( [in] 
XCommandInf oChangeListener Listener ) ; 

}; 



[0479] The function of interface XCommandlnfoChangeListener is equivalent to the other listener interfaces de- 
scribed above. 
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TABLE 77.: Interface XCommandlnfoChangeListener 



interface XCommandlnfoChangeListener : 

com: :sun: :star: : lang: : XEventListener 

( 

void commandinf oChange ( [in] Commandinf oChangeEvent evt 
) ; 

}; 



[0480] Other interfaces that are used include the following. Interface XldlClass provides information about a type or 
module. Every an^ay also belongs to a type that Is reflected as a XldlClass object that is shared by all arrays with the 
same element type and number of dimensions. Finally any of the primitive IDL types are also represented as XldlClass 
objects. This indudes 'Void, any, boolean, char, float, double, octet, short, long, hyper, unsigned octet, unsigned short, 
unsigned long" and "unsigned hyper". Interface XldlClass inherits from interface XInterface. 

TABLE 7 8.: INTERFACE XldlClass 



interface XldlClass: com: : sun: : star :: uno: :XInterf ace 

{ 

sequence<XIdlClass> getClasses () ; 

XldlClass getClass ( [in] string aName ); 

boolean equals ( [in] XldlClass Type ); 

boolean isAssignableFrom ( [in] XldlClass xType ); 

com: : sun: : star: :uno: :TypeClass getTypeClass ( ) ; 

string getName ( ) ; 

[const] com: : sun: : star :; uno: :Uik getUilcO; 
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sequence<XIdlClass> getSuperclasses ( ) ; 

sequence<XIcilClass> getlnterf aces ( ) ; 

XldlClass getComponentType ( ) ; 

XldlField getField( [in] string aName ); 

sequence<XIdlFieid> getPields () ; 

XldlMethod getMethod( [in] string aName ); 

sequence<XIdlMethod> getMethodsO ; 

XldlArray getArrayO; 

void createObject ( [out] any obj ); 

}; 



[0481] Method getClasses returns all types and modules, which are declared in this class. Method getClass returns 
a type or module with the given name that is declared in this class. Method equals retums <TRUE> if the instances 
describe the same type, othenwise <FALSE>. Method isAssignableFrom tests if the parameter xType is a subclass of 
this class. Method getTypeClass retums the type that this instance represents. Method getName retums the fully qual- 
ified name of the type of object (dass, interface, array sequence, struct, union, enum or primitive) represented by this 
XldlClass object Method getUik retums the UIK from this type. If the type has no UIK, the returned UIK Is zero. 
[0482] If this object represents an Interface or a class, the objects that represent the superdasses or superinterfaces 
of that dass are retumed by method getSuperdasses. If this object is the one that represents the topmost dass or 
interface, an empty sequence is retumed. 

[0483] Method getlnterfaces determines the interfaces implemented by the dass or interface represented by this 
object. If the dass or Interface implements no interfaces, the method retums a sequence of length 0. 
[0484] If this dass represents an an-ay or sequence type, method GetComponentType retums the XldlClass object 
representing the component type of the array or sequence; othenwise it retums null. Method getField retums a XldlField 
object that reflects the specified member field of the dass, interface, struct, union, enum or exception represented by 
this XldlClass object. If a field with the spedfied name is not found, zero Is retumed. The field to be reflected is located 
by searching all the memtjer fields of the dass, interface, struct, union, enum or exception represented by this XldlClass 
object for a field with the spedfied name or for NULL, if a field with the spedfied name Is not found. Parameter aName 
spedfies the simple name of the desired field. 

[0485] Method getFields retums a sequence containing Field objects reflecting all the accessible fields of the dass, 
interface, struct, union or enum represented by this XldlClass object. Method getFields retums a sequence of length 
zero if the dass or interface has no accessible fields, or if it represents an an*ay a sequence or a primitive type. 
Spedfically, if this XldlClass object represents a dass, this method retums the fields of this class and of all its super- 
dasses. If this XldlClass object represents an interface, the method retums the fields of this interface and of all its 
superinterfaces. If this XldlClass object represents an array, sequence or primitive type, this method retums a sequence 
of length zero. 

[0486] Method getMethod retums a XldlMethod object that reflects the specified member method of the interface 
represented by this XldlClass object. If a method with the spedfied name is not found, "0" is retumed. The method to 
be reflected is located by searching all the member methods of the interface represented by this Xjdl Class object for 
a method with the spedfied name. Parameter aName specifies the simple name of the desired method. 
[0487] Method getMethods retums a sequence containing XldlMethod objects reflecting all the member methods of 
the class or interface represented by this XldlClass objed, including those dedared by the dass or interface and those 
inherited from superdasses and superinterfaces. Retums a sequence of length 0 if the class or interface has no member 
methods. 

[0488] Method getArray retums interface XldlArray to get and set the elements by index if the represented type is 
an array or sequence. Method createobject creates an instance of the type represented by this XldlClass object if the 
represented type is a basic type, struct, enum, or sequence. 

[0489] Enumeration TypeClass describe all type classes, which can be defined in the IDL. 
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TABLE 79,: Enumeration TypeClass 



enum TypeClass 
{ 

VOID, 
CHAR, 

BOOLEAN, 



BYTE, 
SHORT, 

UNSIGNED_SHORT, 
LONG, 

UNSIGNED_LONG, 
HYPER, 

UNSIGNED_HYPER, 

FLOAT, 

DOUBLE, 

STRING, 

TYPE, 

ANY, 

ENUM, 

TYPEDEF, 

STRUCT, 

UNION, 

ARRAY, 

INTERFACE, 

SERVICE, 

MODULE, 

INTERFACE_METHOD, 

INTERFACE_ATTRIBUTE, 

UNKNOWN 

}; 



[0490] Interface XldlField inherits from interface XtdlMember. 
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TABLE 80. : INTERFACE XldlField 



10 



interface XldlField: 

com: : sun: : star : : reflection : : XldlMember 

{ 

com: : sun : : star : : reflection : : XldlClass getType { ) ; 
com: : sun: : star: ; reflection: : FieldAccessMode 



20 



25 



30 



getAccessMode { ) ; 
any get { [in] any obj ) 
raises ( 

com: : sun: : star: : lang: : IllegalArgumentException ) 
void set( [in] any obj, [in] any value ) 
raises ( 

com: : sun: :star : rlang: : IllegalArgumentException, 
com: : sun: :star: :lang: : IllegalAccessException ) ; 

}; 
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[0491] MethCKl getType returns a XldlClass object that identifies the dedared type for the field represented by this 
XldlField object. Method getAccessMode returns an enumeration value, which denotes whether the field is "const", 
"readonly", "writeonly" or "readwrite". 

[0492] Method get returns the value of the field represented by this field on the spedfied object. The underlying field's 
value is obtained as follows: 

^ If the underlying field is a constant, the object argument is ignored; it may be NULL; 
[0493] Othenvise, the underlying field is an instance field. 

[0494] If the spedfied object argument is NULL, the method throws an "IllegalArgumentException". If the specified 
object is not an instance of the class, interface, stmct, union or enum declaring the underlying field, the method throws 
an "IllegalArgumentException". Otherwise, the value is retrieved from the underiying instance or constant. 
[0495] Method set sets the field represented by this XldlField object on the specified object argument to the specified 
new value. The operation proceeds as follows. If the specified object argument is NULL, the method throws an exception 
IllegalArgumentException. If the specified object argument is not an instance of the class or interface declaring the 
underlying field, the method throws an exception IllegalArgumentException. If the underiying field is constant, the 
method throws an exception IllegalAccessException. If the new value cannot be converted to the type of underiying 
field by an identity or widening conversion, the method throws an IllegalArgumentException. The field is set to the 
possibly widened new value. 

[0496] Interface XldlMember inherits from interface XInterface. Interface XldlMember makes it possible to access 
members of classes dynamically. 
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INTERFACE XldlMember 
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interface XldlMember: com: : sun :: star :: uno :: XInterf ace 
I 

XldlClass getDeclaringClass ( ) ; 

string getNameO; 

}; 



[0497] Methcxj getDeclaringClass returns the XldlClass object representing the class, Interface, struct, union or enum 
that declares the member represented by this member. Method getName returns the fully qualified name of the type 
(class, interface, array, sequence, struct, union, enum or primitive) represented by this XldlClass object, as a string. 
20 [0498] The values in enumeration FieldAccessMode are used to specify the kind of attribute or property. 
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TABLE 82 .: Enumeration FieldAccessMode 



enum FieldAccessMode 

{ . - 

// _ 

/** The property is readable and writeable 
*/ 

READWRITE, 

//—: 

/** The property is readonly 
*/ 

READONLY, 

// _ 

/** The property is write only 
*/ 

WRITEONLY, 

// 

/+★ gdeprecated 

*/ 
CONST 

}; 



[0499] Exception HlegaiArgumentException is thrown to indicate that a method has passed an illegal or inappropriate 
argument. Exception HlegaiArgumentException inherits from exception Exception. Field ArgumentPosition Identifies 
the position of the illegal argument. This field is -1 if the position is not known. 
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TABLE 83.: EXCEPTION IllegalArgumentException 



exception IllegalArgumentException: 
com: :sun: rstar: :uno: : Exception 

{ 

short Argument Pes it ion; 
); 



[0500] Exception lltegalAccessException is thrown when an application tries to change a constant property. Exception 
illegalAccessException inherits from exception Exception, 

TABLE 84.: EXCEPTION IllegalAccessException 



exception IllegalAccessException: 

com: : sun: : star: : uno: : Exception 

{ 

}; 



[0501] Interface XldlMethod inherits from interface XldlMember Interface XldlMember makes it possible to access 
the specification of a method dynamically. ' 



TABLE 85.: INTERFACE XldlMethod 



interface XldlMethod: 

com: :sun: :star: : reflection: :XIdlMember 
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10 
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{ 

XldlClass getReturnType () ; 
sequence<XIdlClass> getParameterTypes () ; 
sequence<ParamInf o> getParameterInf os ( ) ; 
sequence<coin: : sun: :star : rreflection: ;XIdlClass> 

getExceptionTypes ( ) ; 
com: : sun: : star: : reflection: :MethodMode getMode ( ) ; 
any invoke { [in] any obj, [inout] sequence<any> args ) 
raises ( 

com: :sun: : star: : lang: : IllegalArgumentException, 
com: : sun: : star : : reflection: : InvocationTargetException 



) ; 



); 



25 [05021 Method getReturnType returns a XldlClass object that represents the formal return type of the method rep- 
resented by this method object. Method getParameterTypes returns a sequence of XldlClass objects that represent 
the fomial parameter types, in declaration order, of the method represented by this Method object. Method getParam- 
eterTypes returns a sequence of length 0 If the underlying method takes no parameters. 

[0503] Method getParameterlnfos retums a sequence of Paramlnfo objects that represent all information about the 
30 formal parameter types, in declaration order, of the method represented by this Method object. Method getParameter- 
lnfos retums a sequence of length 0 if the underlying method takes no parameters. 

[0504] Method getExceptionTypes returns a sequence of XldlClass objects that represent the types of the checked 
exceptions thrown by the underlying method represented by this Method object. Method getExceptionTypes returns a 
sequence of length 0 if the method throws no checked exceptions. 
35 [0505] Method getMode retums an enumeration value, which denotes whether the method is one-way or two-way. 
Method invoke invokes the underlying method represented by this method object on the specified object with the 
specified parameters. Individual parameters are subject to widening conversions as necessary. 
[0506] Method invocation proceeds in the following order: 

40 If the specified object argument is NULL, the invocation throws an lllegalArgumentExceptlon; and 

Otherwise, if the specified object argument is not an instance of the class or interface declaring the underlying 
method, the invocation throws an exception lltegalArgumentException. 

45 [0507] If the number of actual parameters supplied via args Is different from the number of formal parameters required 
by the underlying method, the invocation throws an Exception IIIegalArgumentException. For each actual parameter 
in the supplied args an^y, if the parameter value cannot be converted to the corresponding formal parameter type by 
an identity or widening conversion, the invocation throws exception IIIegalArgumentException. When the control trans- 
fers to the underlying method and the method stops abruptly by throwing an exception, the exception is placed in an 

50 exception InvocationTargetException and thrown in tum to the caller of the method. If the method completes normally, 
the value it retums is returned to the caller of the method. If the underlying method returns type is void, the invocation 
retums VOID. 

[0508] Structure Paramlnfo describes a format parameter of a method. 
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TABLE 86.: STRUCTURE Paramlnfo 



struct Paramlnfo 
{ 

/** The name of the parameter. 
*/ 

string aName; 

// 

/** One of the values IN, OUT, INOUT from the ParamMode 
enumeration. 
*/ 

ParamMode aMode; 

//^^. 

/** The type of the parameter. 
*/ 

XldlClass aType; 
}; 



[0509] The values in Enumeration ParamMode are used to specify if a formal parameter of a method is used for 
input, output or both. If the value is an IN parameter, data can only transferred from the callee to the caller. If the value 
is an OUT parameter, data can only transferred from the caller to the callee. If value Is an INOUT parameter, data can 
be transferred in both directions. 

TABLE 87. : ENUMERATION ParamMode 



enum ParamMode 
{ 

IN, 

GUT, 

INOUT 

}; 
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[0510] The values in Enumeration MethodMode are used to specify the calling mode of a method. If the value is an 
ONEWAY parameter, the method call may be asynchronous. If the value is a TWOWAY parameter, the method call is 
synchronous, 

TABLE 88.: ENUMEEU^TION MethodMode 



enum MethodMode 
i 

ONEWAY, 

TWOWAY 

}; 



[0511 J Exception InvocationTargetException is a checked exception that wraps another exception. Typically such 
exceptions are thrown by an invoked method or constructor. Exception InvocationTargetException inherits from excep- 
tion WrappedTargetException. 



TABLE 89-: EXCEPTION InvocationTargetException 



exception InvocationTargetException: 

com: : sun: :star: :lang: : WrappedTargetException 

{ 

}; 



[0512] Exception WrappedTargetException is a checked exception that wraps an exception thrown by the original 
target. Normally this exception is declared for generic methods. Exception WrappedTargetException inherits from ex- 
ception Exception, 
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TABLE 90.: EXCEPTION WrappedTargetException 



exception WrappedTargetException : 

com: :sun: :star: ;uno: : Exception 

( 

any TargetException; 



[0513J Interface XWMrray provides methods to dynamically access arrays. I nterfaceX/dMrray inherits from interface 
XInterface. 
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INTERFACE XldlArray 



interface XldlArray: com: :sun: :star: :uno: rXInterface 
( 

void realloc( [incut] any arrayr [in] long length ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException ) ; 
long getLen( [in] any array ) 
raises ( 

com:: sun: : star :: lang: : IllegalArgumentException ); 
any get ( [in] any aArray, [in] long nindex ) 
raises ( 

com: : sun: : star: ; lang: : IllegalArgumentException, 
com: : sun: : star: : lang: : ArraylndexOutOf BoundsExcepti 
on ) ; 

void set ( [inout] any aArray, [in] long nindex, [in] 
any aNewValue ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException, 
com: :sun: :star: :lang: : ArraylndexOutOf BoundsException 
) ; 

}; 



[051 4] Method realloc in interface XldlArray changes the size of the array to the new size. If the new length Is greater, 

the additional elements are default constructed, otherwise the elements are destojcted. Method realloc throws an 

exception IllegalArgumentException if the specified object is not an an^ay or if the specified object is null. 

[051 51 Method getLen in Interface XldlArray returns the number of elements in the array. Method getLen throws an 

exception IllegalArgumentException if the specified object is not an array or if the specified object is null. 

[051 6] Method get in interface XldlArray returns the value of the indexed component in the spedfied an-ay object. 

Method get throws exception IllegalArgumentException, if the specified object is not an anray or If the spedfied object 

is null. Method get throws exception ArraylndexOutOfBoundsException. if the specified index argument is negative, 

or if the spedfied index argument is greater than or equal to the length of the specified an^y 

[051 7] Method set in interface XldlArray sets the value of the Indexed component of the specified array object to the 

spedfied new value. Method set throws exception IllegalArgumentException, if the specified object is not an array or 

if the specified object is null. 

Method set throws exception ArraylndexOutOfBoundsException, if the spedfied index argument is negative, or if the 
spedfied index argument is greater than or equal to the length of the spedfied array 

[0518] Exception ArraylndexOutOfBoundsException is thrown to indicate that an an^y has been accessed with an 
illegal index. The index is either negative or greater than or equal to the size of the array. Exception ArraylndexOutOf- 
BoundsException inherits from exception IndexOutOfBoundsException. 
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TABLE 92.: EXCEPTION 
ArraylndexOutOfBoundsEKception 



exception ArraylndexOutOf BoundsException : 

com; ;sun: :star: :lang: : IndexOutOf BoundsException 

{ 

}; 



[0519] Exception IndexOutOfBoundsException is thrown to indicate that a container has been accessed with an 
illegal index. The index is either negative or greater than or equal to the count of the elements. Exception IndexOutOf- 
BoundsException inherits from exception Exception. 



TABLE 93.: EXCEPTION IndexOutOfBoundsException 



exception IndexOutOfBoundsException : 
com: : sun: : star: : uno: : Exception 

{ 

}; 



[0520] Those skilled in the art will readily understand that the operations and actions described herein represent 
actions performed by a CPU of a computer in accordance with computer instructions provided by a computer program. 
Therefore, the various processes described herein, and the Interfaces described herein may be implemented by a 
computer program causing the CPU of the computer to carry out instructions representing the individual operations or 
actions as described hereinbefore. The computer instructions can also be stored on a computer-readable medium, or 
they can be embodied in any computer-readable medium such as any communications link, like a transmission link to 
a LAN. a link to the internet, or the like. 

[0521] Thus, the processes and/or interfaces can be implemented by a computer program comprising computer 
program code or application code. This application code or computer program code may be embodied in any fomi of 
a computer program product. A computer program product comprises a medium configured to store or transport this 
computer-readable code, or in which this computer-readable code may be embedded. Some examples of computer 
program products are CD-ROM discs, ROM cards, floppy discs, magnetic tapes, computer hard drives, servers on a 
network, and carrier waves. The computer program product may also comprise signals, which do not use carrier waves, 
such as digital signals transmitted over a networtc (including the Internet) without the use of a carrier wave. 
[0522] Herein, a computer memory refers to a volatile memory, a non-volatile memory, or a combination of the two 
in any one of these devices. Similariy, a computer input unit and a display unit refer to the features providing the required 
functionality to input the infomnation described herein, and to display the information described herein, respectively, in 
any one of the aforementioned or equivalent devices. 

[0523] In the following, further embodiments of the invention will be described with respect to Figs. 23-33. 
[0524] Referring to Fig. 23, the networtc portal system 2310 according to the invention is illustrated to be placed 
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between provider systems 2301 A, 2301 B and client systems 2302A, 2302B in a network 2303. Between the network 
portal system 2310 and the clients 2302A. 23028 placed is a network server 2312 which in turn is connected to the 
network 2303. If the network 2303 is the internet, the network server 231 2 may be an HTTP server The network server 
2312 is adapted for perfomiing communication with any client system 2302A. 2302B via the network 2303, for ex., 

5 receiving requests for content from client systems and transmitting responses produced within the network portal sys- 
tem 2310 to the respective dient systems 2302A . 2302B, aient system 2302A is illustrated to be a computer, and is 
supposed to execute an intemet browser program. Client system 2302B is illustrated to be a mobile telephone which 
is linked to a mobile telephone network 2304 which has a gateway 2343 to the network 2303. The provider systems 
2301 A. 2301 B are adapted to offer content such as data bases, file systems, for access or use for client systems 

10 2302A. 2302B. Provider systems providing arbitrary other content may be linked to the network, too. It is to be noted 
that the communication connections mentioned here may be of permanent or temporary nature. They may be physically 
direct or indirect. 

[05251 A portal may be an interface system which is placed between provider systems and client systems in a network, 
for enabling communication between the provider systems and the client systems. Provider systems may be computer 
IS systems which provide content or services via a network to client systems. The client systems represent the user of 
the content or services. 

[0526] In this context, the tenn "content" may denote any information, which may be of any kind, and comprised in 
any physical or logical format which is suitable to be transmitted over a communication network. In particular, content 
may be of the form of electronic files, residing on a sender, or it may be generated by a particular program application. 
20 [0527] The term "service" may comprise in particular communication based services (e.g.: e-mail, ftp transmission) 
as well as rendering functionality like word-processing or drawing capabilities, or rendering infomiatlon content (e.g., 
documents). 

[0528] The great number of different content and services available over a network like the intemet have lead to an 
enormous variety of different communication standards, data formats and file formats, which are sometimes proprietary 

25 for the particular content and sen^ices. Comm unication standards, i.e. , protocols which define the way of communication 
of between two systems, and the Ml ME type which defines the type of content, are here referred to as communication 
schemes. In general, the communication scheme supported by a system is contained in the system's identifier in the 
network, or in the identifier of the particular serwce or content provided by the system. As identifier for systems, services 
or content, the Uniform Resource Locator (URL) is used. A URL always starts with a communication scheme which is 

30 to be used for accessing the appropriate provider system. An example may be: "imap://user@mailserverAinbox". The 
communication scheme is here the IMAP protocol. This URL specifies a message which is located in a folder "inbox" 
of a provider system "mailserver ". 

[0529] As a consequence, services or content provided by some provider systems may be incompatible with services 
or content provided by other provider systems and thus have a "stove-pipe" nature as to their presence and operation 

35 on networks. In addition, there exist many different communication schemes for content or service, which communi- 
cation schemes again may be incompatible and not universally accessible or supported by all client systems. 
[0530] The inventive network portal system 2310 according to the embodiment illustrated in Fig. 24 is divided into 
several subsystems. One of them are the means 241 1 which are adapted to deliver content in a communication scheme 
as required by the particular client systems 2302A, 2302B. The means 2411 are refen-ed to as a webtop. 

40 [0531] Another subsystem of the network portal system 231 0 is constituted by the means 2413 which interact with 
the provider systems 2301 A, 2301 B for accessing and retrieving content. These means 241 3 are referred to as universal 
content broker (UCB) 2413. 

[0532] The webtop 2411 is a software implementation to provide a metaphor to client systems for accessing content. 
The webtop 2411 comprises a user interface which is defined in different XML. HTML or WML templates in order to 

45 be able to present content in the fomn as required by any individual client system. These templates define together 
with the stylesheets and the rendering process the visual look and feel of the networic portal system 2310. Hereby, the 
templates define elements of the content to be presented. Examples of such elements are text, tables, images, file 
names. The stylesheets define the form how the elements are to be presented on an individual client system. As an 
example, a stylesheet may define the layout of the elements on a page to be displayed on the a screen. To deliver 

50 content to a client system via this rendering process, the content has to become a part of the template. On the other 
hand, the content is not static and will change over time, and also the templates are independent from the client system. 
[0533] Depending on the capabilities of a particular client system which communicates with the webtop 2411 . one 
of these templates is selected for interaction with the particular client system. The webtop 2411 loads the template, 
fills in all user specific content data, and this new temporary template is processed by a stylesheet and transmitted to 

55 the client system. 

[0534] For example, if the user is accessing his email via a browser, the template will be an HTML file. The webtop 
2411 uses UCB 2413 to get the content of the mails and insert the data as an HTML table in the HTML template. This 
template includes the user specific mail data, and is then processed through the stylesheets and transmitted to the 
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client system. 

[0535] The webtop 2411 may be implemented in Java as different servlets, so it can easily communicate with different 
kinds of network servers 2312. The webtop 24 1 1 is using a special template core engine, which Is able to insert dynamic 
data into the templates and renders these templates according to different stylesheets. With these stylesheets, the 
5 webtop 241 1 can be adapted to special client systems or user purposes. It comprises for example the logic for presenting 
e-mail content In a kind of folder view to a client system. 

[0536] As concept for offering content to a variety of different client system, the framework of individual data repre- 
sentation according to Annex II may be applied. By definition of dynamic content channel "portlets". highly customizable 
content pages may be produced for any individual client system. Every portlet defines in which format the content can 
10 be provided. The client can subscribe to any of the available portiets. The framework and all portlets are implemented 
as servlets running on the webtop 2411 . 

[0537] With respect to client systems, the webtop 2411 may perform login procedures. Furthermore, authentication 
procedures for client systems may be required for requesting particular content from the network portal system 2310. 
[0538] The UCB 2413 interacts with the provider systems for retrieving the content requested by a client system. 
15 The access is performed on the basis of the request transmitted by the client system to the network portal system 
231 0. The request specifies the service, and comprises an indicator specifying the client system and the communication 
scheme to be applied for communicating with the client system. 

[0539] As an example, the UCB 2413 may provide an hierarchical view to all content, which is provided by a provider 
system, regardless of the content type. A unified navigation through all content can be may be enabled for all kinds of 

20 . client systems. The standard information exchange services like e-mail, news, calendar, directory, databases, internet 
communication, web content and file storage are supported by the UCB 2413. and for the integration of additional 
content or applications, interfaces for the integration of content providers are supported by the UCB.241 3. For example, 
on top of the UCB 2413, an application is able to navigate through the e-mails of an client like navigating through a 
calendar server. The hierarchical view to all this information can be configured dynamically. 

25 [0540] The provider systems 2301 A. 2301 B which may be accessed by the UCB 2413 for retrieving content are 
contained in a provider register 2415 in association with the communication scheme they support. The UCB 2413 has 
access to that provider register. Optionally, the UCB 2413 is maintaining the provider register 2415, I.e., registering 
provider systems, or de-registering provider systems. 

[0541] In a further embodiment of the networic portal system 2310. the UCB 2413 is adapted to store content in a 
30 local storage 2416. The content is stored In association with the URL of the content. This feature pemilts using or 
processing the content without being permanently connected to the provider system where the content has been re- 
trieved from. 

[0542] The interface used in the UCB 2413 for storing content allows the usage of different implementations. For a 
small networic portal system 2310. the functionality of ttiis implementation may be an ordinary file. To provide scalability 
35 of the networic portal system 231 0, a database can be used with an adapter providing the implementation of the inter- 
face. This opens a functionality not just using the UCB 241 3 to access this content, but also other application software 
may woricing together with the database to access the stored content. 

[0543] For increasing the availability of a network portal system, the replication features of a database system may 
be used for maintaining an identical copy of the database on a second computer system. Then, if the first computer 

40 fails by a hardware or software failure, the second computer system can provide the same functionality like the first one. 
[0544] In a further embodiment, the UCB 2413 is adapted to associate properties to content which is retrieved from 
a content provider system. These properties may contain additional infomnation with respect to the content. The prop- 
erties are set or changed by the UCB 241 3. The properties or attributes are transmitted along with the retiieved content 
to the respective client system. The properties along with the association witti the content (referenced by its URL) are 

45 Stored in a storage which is accessible by the UCB 241 3. Whenever a request for the content is received by the UCB, 
the storage Is looked up for its associated properties on the basis of its URL. The properties may then be transmitted 
along with the content to the client system. 

[0545] The retrieval of content by the UCB 2413 is explained with reference to Figures 25 to 27. 
[0546] Fig. 25 illusti-ates the retrieval of content constituting a message on an I MAP server with an associated prop- 
so erty. An example for such an URL may be: imap://user@mailserver/inbox;UlD=3. Accordingly, the content has an 
associated property value UiD set to 3. In the first step 2501, the URL is passed from the webtop 2411 to tiie UCB 
2413. In step 2502, the UCB 2413 searches the appropriate provider system for the IMAP communication scheme 
based on the provider register to which the UCB has access. Then, in step 2503, the UCB connects to the appropriate 
provider system and tiransmits ttie URL to it. In step 2504, the provider system analyzes the URL and creates an IMAP 
55 message content. In step 2505, tiie IMAP message content is transmitted back to the UCB 2413. In step 2506, the 
UCB 2413 passes the received content to the webtop 2411. which in turn fits it into the template and fonwards it to the 
client system (step 2507). 

[0547] Fig. 26 illusti-ates an example of setting a property value which Is associated witii a message of an IMAP 
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server. Upon request by a client system, the UCB 2413 performs a step 2310 for retrieving content as specified by the 
URL of the IMAP message. Then, in step 2620, the value of the content property "IsRead" is set to "true". In step 2630. 
the UCB 241 3 connects to the IMAP server and instructs the IMAP server to mark the message as read. In step 2640, 
the message data in a cache storage in USB 2413 is updated. 

5 [0548] A property may also be retrieved from a message on an I MAP server. Rg. 27 illustrates an example of retrieving 
a property value. First, the UCB checks whether the message data is stored in a local cache of the networic portal 
system 231 0 (step 2750). If so, the property value Is retrieved from the local cache (step 2760A). Othenwise, the UCB 
241 3 connects to the IMAP server and downloads the message (step 2760B). The downloaded message is then stored 
in the local cache (step 2770B). In both cases, the property value is read and returned to the client system (step 2780). 

10 [0549] The UCB 241 3 may be further adapted to automatically notify individual client systems whenever new content 
is created by the UCB 24 1 3. To this end, the functionality of creating new content is associated with the individual client 
systems ("listeners"). When the UCB 2413 creates new content, the UCB 2413 notifies the individual listeners. 
[0550] Further, the UCB may be adapted to automatically notify individual client systems whenever particular content 
is processed by the UCB 2413. For this functionality, the UCB 2413 maintains a register where the URL of the content 

15 is associated with the URL of the individual client systems to be notified are registered. Then, whenever content is 
processed, it is verified whether there is an association of that content with listeners. If so, the associated listeners are 
notified. 

[0551] The notification may be dependent upon the kind of content processing. Some listeners may be informed 
whenever content is changed, some listeners may be infomned when content is deleted. 
20 [0552] The notification mechanism may be used for synchronizing several client systems, i.e. . for updating content 
changes initiated by one client systems to other client systems. 

[0553] The generic application programming interface (API) for a content provider system can be extended by ad- 
ditional content or services because the UCB 2413 is based on a component technology which is able to support 
dynamic interfaces. This allows a system architect not only to use the UCB 2413 as a kind of central access system 

25 to all content or services, nor it is only a kind of navigation system for users to go through the available content, it 
provides moreover an infrastructure for building large enterprise applications, where the ability for acting with different 
content and the exchange of content is required. The uniform access guarantees that the whole system can be adapted 
to different infrastructures, without interfering the different applications on top of the UCB 2413. 
[0554] Depending on the capabilities of a client system, the networic portal system 2310 can not only provide the 

30 infomiation to a userfor viewing content. If a client system 2302A, 2302B is able to execute Java applications, particular 
Java components 2414A, 2414B can be used in the templates which deploy the functionality of a word-processor or 
spreadsheet to the client system 2302A, 2302B. Using a standard Java enabled intemet browser, a user may be able 
to write or only change very complex documents on any client system 2302A, 2302B running just a browser which has 
a networic connection to the networic portal system 2310. Another solution is to dynamically transcode from one file 

35 format to another while transmitting the content. For a native running application on, for example, a palm system this 
enables the ability to modify a document using this client system. Later, the modifications made on the palm system 
documents can be transmitted back to the networic portal system 2310 and can be applied to the document in the 
original format. 

[0555] For client systems 2302A, 2302B which are not permanently connected to the network 2303, the networic 
40 portal system 2310 provides the ability to synchronize the content of the two UCB via a synchronization component 
2414C. A user can read and change his documents while being off-line and after he is going online he can synchronize 
all this changes with the networic portal system 2310. 

[0556] Optionally, the webtop serviet is accessing tiiis information by using the network portal system API. This is a 
language independent API for accessing all the functionality of a predetemiined Office program bundle comprising 
45 word-processing, drawing, calculating, tabulating, file displaying capabilities. Then, the same UCB 2413 can be used 
by the Office program bundle and also by the networic portal system, so a client can use the Office program bundle 
while working in his office and on the other hand he can use the network portal system to access all his files and 
infomiation via the networic portal system when he is not in his office. 

[0557] Next, by referring to Fig. 28, the inventive methcxl for linking a plurality of provider systems with a plurality of 
50 client systems via the network portal system 2310 is explained. In step 2810, a content request is received from a 
client system (2302A, 2302B), said request comprising a content indicator being indicative of the content, and an 
indicator of the requesting client system (2302A, 2302B), said client system indicator specifying the communication 
scheme supported by said client system (2302A, 2302B). Then, in step 2820, a provider system (2301 A, 2301 B) is 
searched which is able to provide said requested content. In step 2830, said selected provider system (2301 A, 2301 B) 
55 is accessed. In step 2840. said requested content is retrieved from said accessed provider system (2301 A, 2301 B). 
Finally, in step 2850, the retrieved content is rendered to said requesting client system (2302A, 2302B) according to 
the communication scheme of said requesting client system (2302A, 2302B). 

[0558] Next, by referring to Figs. 29 and 30, the method for providing content to a client system is explained. The 
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client system requesting content is a mobile telephone 23026. 

[0559] First, in step 2901, the HTTP server 2312 receives a request sent from the mobile telephone 2302B. The 
request comprises the requested content as well as the URL of the mobile telephone 2302B. The request is passed 
by the HTTP server 2312 to the webtop 2411 of the network portal system 231 0 (step 2902). 
5 [0560] tn the step 2903, a login procedure for the mobile phone 2302B onto the webtop 2411 is started. If the login 
fails, the webtop 2411 initiates an administration procedure 2916 in which an ID and a password for client system 
2302B is defined. The administration procedure 2916 will be described later. 

[0561] On the other hand, if the login in step 2903 is successful, an authentication procedure 2904 is started in which 
the identity as well as accessing rights of the mobile telephone 2302B are verified. If the authentication fails, the client 
10 administration procedure 2916 is initiated. 

[0562] If the authentication in step 2904 is successful, the webtop 2411 selects the template as specified by the 
received URL (step 2905). 

[0563] The content request is passed from the webtop 2411 to the UCB 2413 (step 2906), which in turn accesses 
the provider register and selects therefrom the appropriate service provider system 2301 A, 2301 B for retrieving the 
15 content (step 2907). 

[0564] The content is then delivered by the selected provider system 2301 A. 2301 B to the UCB 2413 (step 2908). 
The UCB 2413 passes the received content to the webtop 2411 as it is (step 2909). Then, in step 2910, the webtop 
2411 checks whether or not the communication schemes of the provider system and client system match. If not so, 
the webtop 241 1 invokes a conversion procedure (step 301 1) is in which an appropriate conversion component 2418A, 
20 241 8B for converting the content of the provider's scheme into a representation according to the client's scheme is 
executed. The conversion procedure will be described later in connection with Fig. 33. 

[0565] Then the webtop 241 1 fits the converted information into the selected template (step 301 2). Then, a stylesheet 
according to the MIME type of the client system 2302B is selected (step 3013). The template is rendered according to 
the selected stylesheet (step 3014), fonwarded via the HTTP server 2312 to the client mobile phone 2302B having 

25 requested the content (step 3015). 

[0566] On the other hand, if the communication scheme of the selected provider 2301 A, 2301 B con^esponds to the 
communication scheme of the client 2302B, step 3011 is stepped over, and the retrieved information can be fit directly 
without further change into the template, rendered according to the selected stylesheet and forwarded via the HTTP 
server 231 2 to the client system 2302B. 

30 [0567] Next, referring to Fig. 31 , the administration procedure 2916 an administration procedure in which an ID and 
a password for a client system is described in greater detail. In step 3101. the webtop 2411 selects a stylesheet ac- 
cording to the communication scheme of the client system. In step 3102, a login template according to the communi- 
cation scheme of the client is rendered. A number of login templates, each being specific for a certain MIME type, are 
available to the webtop 2411. In step 3103, the selected login template is transmitted, via the HTTP server 2312, to 

35 the client system requesting the login. Upon receiving the login template, the client system can initiate the login pro- 
cedure (step 31 04). This login procedure comprises defining a login and a password for the client system (step 31 05). 
[0568] Referring now to Fig. 32, a case is described where the client system is a computer 2302A executing a browser 
program, which accesses the network portal system 2310 for requesting content to be displayed within the browser 
For displaying the content, the service of a specific drawing component 241 4A is assumed to be necessary. This 

40 component 2414A is hosted in the network portal system 2310 together with other service components 2414B, 2414C. 
For using the services of said components 2414A, 2414B, 2414C, specific applets are provided by the network portal 
system 2310. These applets have to be transmitted from the network portal system 231 0 to the client computer 2302A 
prior to the content. 

[0569] The login procedure for computer 2302A is basically the same as described above in connection with Fig. 31 
45 and is omitted here. 

[0570] From the browser program being executed on computer 2302A a request to the HTTP server 2312 is sent 
for retrieving the content (step 3202). The request is passed to the network portal system 231 0 (step 3201). The webtop 
2411 selects the template and the specific applet for using the drawing service of component 2414A (step 3202). The 
content identifier URL is entered into the template (step 3203). The webtop selects as stylesheet according to the 
50 MIME type "HTML" (step 3204). and renders the template accordingly. The applet, embedded into an HTML page 
according to the selected template, is transmitted to the computer 2302A (step 3205). 

[0571] Now, the procedure for providing the requested content is started. First, the specific applet being executed 
on client computer 2302A connects to the webtop 2411 (step 3206). The related service component 2414A is called 
in order to load the content as specified by the URL (step 3207). The content is requested from the UCB 2413 (step 
55 3208). The UCB 24 1 3 in turn accesses the content according to the URL and passes it to the service component 241 4A 
(step 3209). The service component 2414A. upon call by the related applet on the client computer 2302A. renders the 
service necessary for drawing the content information in the browser upon transmitting it to the client computer 2302A 
(step 3210). 



103 



EP 1 126 681 A2 



[0572] Referring to Fig. 33, the conversion of content is described. Conversion is invoked whenever content according 
to one communication scheme is to be transcoded into content according to another communication scheme. 
[0573] First, it is checked whether the webtop 2411 can process the content (step 3301). If not so, an en-or message 
is issued to the client system (step 3302). On the other hand, if the webtop 2411 can process the content, it is then 
checked (step 3303) whether the content is to be edited on the client system or only to be displayed there. If the content 
is only to be displayed on the client system, the best matching communication scheme supported by the client system 
is selected as scheme of conversion (step 3304). Then, the con-esponding conversion component 2418A is executed 
in order to convert the content (step 3305), and the converted document is then ready for being transmitted to the client 
system as described above. 

[0574] On the other hand, if the content is to be edited by using webtop functionality, it is checked whether the client 
system is able to execute the corresponding Java applets which invoke the editing functionality (step 3306). If so, the 
webtop 2411 generates a template for a HTML page with an applet embedded therein and sends it to the client system 
(step 3307). The conversion of the content is perfomied on the fly when transmitting it to the client system (step 3308). 
[0575] However, if the client system is not able to execute Java applets, steps 3304 and 3305 are performed as 
described above. 

[0576] If content is represented in XML fomiat, this offers the potential for the synchronization of content between 
various content provider systems that implement the same content schema but obtain or store content differently. The 
synchronization process them becomes a comparison of time stamps and / or the comparison of the XML content, 
which are both functions independent of the content provider systems. Thus there can be networic portal content pro- 
viders that are implemented for various personal digital assistants (PDAs) which can send and receive XML documents 
conforming to schema for document areas as such as addressing, calendar and scheduling, and mail. 
[0577] Special purposes may be applications designed for being executed on particular platfomis like handheld 
computers or mobile telephones, where storage and processing capabilities are particulariy limited. Nevertheless, the 
whole functionality of the framework is still accessible. 

[0578] The synchronizing of content may also be extended to area of multi-user operation when numerous people 
may be operating on various areas of the content. 

[0 579] The networic portal system offers not only a powerful way of treating heterogeneous content in a homogeneous 
manner but a way to group heterogeneous content together with networic information about content. In a further em- 
bodiment of the invention, a networic is created which stores URLs that are organized according to the defining se- 
mantics or hierarchy of another client rather than the semantics or hierarchy that the content prescribes. This also 
includes the structure of the content. Networic content is not defined by the structure of the content and its c:hildren. 
Thus content may be related to each other in an a-cyclical manner rather than in the direct manner that file systems 
are represented. In addition it is possible to inherit networic content structure and augment or modify it without modifying 
the original. 

[0580] An example is a network portal system specially used for management of projects on which different teams 
are woricing. For the automobile manufactures most often a team of engineers, martceting specialists and finance 
experts are. working together One team mostly need some information from the other and also provides information 
to the other. The only difference is which data is important is important for one team and how these should be organized 
in the best way for them. For example the engineering team will produce CAD-drawing and detailed lists of item needed 
to build a peace of an automobile of the project. On the other hand the finance experts are not interested in the CAD- 
drawing and also not on the detailed list of items. They are more interested in overall summary which items are need 
to build the special peace, so they can calculate the price for this and overall calculate the price for the car. The 
marketing team may be interested in the drawings, because give some feedback if the colors will be accepted by the 
customers. So every is woricing on the same project and also on the data files, but the focus which data is used can 
be completely different. 

[0581] The networic portal system provides this infrastructure by the capability of the UCB to browse through all 
content and information using the UCB. Adding user specific or task specific properties to a content, enables the sorting 
or the creation of an hierarchical view to this information, which can be completely different to the physical structure 
on the disk. 

[0582] It is also possible to build a similar system using the Java 2 Enterprise Edition as a base system and at the 
logic and management functionality on top of this in form of Java application or Java beans. Also the whole UCB system 
can be realized on top of a database, for example an object oriented database or a XML-database. 
[0583] Referring to the Annex I, an overview of the framework for implementing the networic portal system is presented 
as defined in the interface definition language files. Via these interfaces, the following operations can be achieved: 
Content is jDrovided. Content is obtained from content providers. Content is defined. The interfaces may be implemented 
in software anci/or hardware components. 
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Content providing. 

[0584] The network portal system provides services to register and maintain implementations of content provider 
systems. Content provider systems are classified according to what unifonn resource locator (URL) schemes they 
implement The scheme is the protocol used to connect to the site or host For Web sites the scheme is http. For IMAP 
or FTP sites, the scheme is (respectively) imap or ftp. 

[0585] Thus given a URL the scheme may be obtained. If a content provider system 2301 A, 2301 B is registered with 
the con-esponding URL scheme then content may be obtained for the URL. 

[0586] The main network portal service that manages content providers Is the UniversalContentBroker and is a one 
instance service that implements interfaces, including the registering and de-registering interface. 
[0587] Content provider objects implementing the XContentProvider interface may register and de-register with cor- 
responding schemes. In addition the list of registered content providers may be obtained with their corresponding 
schemes. 

[0588] The UniversalContentBroker also implements the XContentProvider interface. Thus it may generate content 
for all schemes registered and the client does not have to query all content providers. Content is generated via the 
queryContent method which takes an XContentldentifier reference and returns an XContent reference. 
[0589] The XContentlndentifierFactory interface is created from a URL of a content identifier which contains further 
characterizing information: URL and content identifier. 

[0590] The XContentldentifier interface provides methods for maintaining a URL. The URL may be set just once 
using the setContentldentifier method. Its scheme may be retrieved using the getContentProviderScheme. Thus the 
XContentProvider queryContent method will call the getContentProviderScheme to see if it supports the associated 
scheme before creating content XContentlndentifier references can be created using the XContentlndentifierFactory 
reference of the UniversalContentBroker service. 

Getting content from a provider system. 

[0591] Content will be provided by implementing a set of network portal interfaces. A content object will be created 
by a content provider when an appropriate URL via the XContentldentifier reference is passed to the queryContent 
method of an XContentProvider reference. 

[0592] An example of how content may be obtained is presented in the Annex I, which is referred to in the following. 
Given a factory interface m_xFac an XInterface reference to the UniversalContentBroker service is created. The three 
interfaces that the UniversalContentBroker implements are then obtained. Next an XInterface reference to an FTP 
content provider service is created. The XContentProvider interface reference is then obtained from this. The 
m.xFTPCP XContentProvider reference is then registered with the m_xCPM XContentProviderManager reference via 
the regsiterContentProvider method. A XContentldentifier reference xCID is then created with the URL ■ftp://rimmer/ 
pub*. The XContentProvider reference m_xCP of the UniversalContentBroker service is then used to obtain an XCon- 
tent reference via the queryContent method. 

[0593] Once a reference to the xcontent is obtained it is possible to transfonm this to other interfaces that the content 
object implements. 

Content objects. 

[0594] A content provider will provide objects that implement a set of interfaces that define: The type of content, 
notification of when content changes state, how content may be created from this content, what children this content 
has, what commands may be performed on the content, what properties set and obtained. 

[0595] Note that not all aspects of the above may be defined. It will obviously depend on the type of content created./ 
[0596] An XContent reference will be return by an XContentProvider. This is a simple interface which will retum a 
MIME type representing the type of content. In addition clients of the content may add themselves as listeners on the 
content by implementing the XContentEventListener interface and passing the reference to the addContentEventLis- 
tener method. 

[0597] When action on content is performed registered clients will get notified via the contentEvent method. Notifi- 
cation occurs when content is: 

Inserted. 

This occurs when a child is inserted into the content. For example if a directory folder is opened its content may 
be inserted asynchronously into the folder A client responsible for the display of this content may then update its 
view according to the new content. 
Removed. 
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This occurs when content is removed, but not deleted. An example of this may occur if child content is moved to 

a different parent. 

Deleted. 

This occurs when the content is physically destroyed. That Is the content no longer persists. 
5 - Changed. 

This occurs when the content has changed its Identity. For example if a directory folder has changed its name. 
Matches search criteria. 

This occurs when one or more child contents match search criteria. 

10 [0598] A content object that has children can implement the XIndexAccess interface. This inherits from the XEIe- 
mentAccess interface. This may be used for content to return children that are also content. The type any returned 
from the getBylndex method may be cast according to the XContent interface if its valid to do so. Thereby a directory 
or folder content may retum Its children in this way. . 

[0599] A content object that also creates content will'implement the XContentCreator interface. This defines what 
15 type of content may be created via the queryCreatableContentslnfo method. This will return a sequence of Contentlnfo, 
which just contains the mime type of content that may be created. 

[0600] New content can be created by calling the createNewContent method with the appropriate Contentlnfo. This 
method does not persist the content since what has been created has not been initialized. Initialization may result in 
property and command operations on the new content. When the content has been initialized it can be inserted into 
20 the parent using the insertcontent method. 

[0601] Given a command and task environment an XCommandTask reference will be returned by the method cre- 
ateCommandTask. The command structure inherits from Commandlnfo and additionally contains a field for any which 
represents the arguments passed as a reference to an object. 

[0602] The XCommandlnfo Interface will be obtained from the XCk>mmandTaskProcessor. This interface will be used 
25 to obtain and query possible commands. The Commandlnfo structure contains the attributes of the command. 

[0603] An XCommandTask reference is obtained from an XCommandTaskProcessor that the content object imple- 
ments. It inherits from the XContentTask interface which contains methods to operate on the task at hand. This interface 
is explained after the properties interfaces, which also use the XContentTask interface, have been presented. 
[0604] The XPropertyTaskProcessor inherits from the XMultiPropertySet interface. This interface encapsulates sim- 
30 liar behavior as the XCommandTaskProcessor interface. Given a type of set of properties and an operation to be 
performed via the PropertyTaskType (either a set or a get) a XPropertyTask reference will be created from the create- 
propertyTask method. 

[0605] The querying of property types is perfomned through the XMultiPropertySet interface. Thus a content object 
will have to implement this interface too. 
35 [0606] A reference to an XPropertyTask will be obtained from the XPropertyTaskProcessor. Like the XCommandTask 
this inherits from XContentTask such that the operation can be executed. 

[0607] The XContentTask interface is a super interface that is used by both the XComandTask and XPropertyTask 
interfaces. It provides methods to perform the task synchronously or asynchronously via the execute and start methods 
respectively. If performed asynchronously then event notification will occur through the XContentTaskEnvironment. A 
40 reference to the XContentTaskEnvironment is passed when the XContentTask is created by the associated command 
or property processor interfaces. 

[0608] The XContentTaskEnvironment provides a context for tasks handle en'ors and notify when tasks have changed 
status. An implementation of the XContentTaskEnvironment interface will. also include the ability to set the XContent- 
TaskCiient reference which is used provide task status feedback. 
45 [0609] A client wishing to run tasks on content, either commands or properties will need to Implement the XContent- 
TaskCiient interface. When task state changes the client will be notified via the contentTaskEvent method. Status will 
include the old and new state of the task and the XContentTask reference associated with the change in state. The 
state of the task can be one of the following: 

50 - Created, 
Running, 
Done, 
Aborted. 

55 Obtaining children from content. 

[0610] From the content a reference to the XIndexAccess is obtained. The number of children is obtained from the 
getCount method. Each child is then obtained via the getBylndex method, which is of type Any. If Any can be cast to 
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a reference to a pointer to XContet then a reference, XContent is obtained. The XContentldenitifier reference is then 
obtained from XContent. From this the scheme is printed out. From XContent the MIME type is printed out. 

Executing tasks on content objects. 

5 

[061 1] Once an XContent reference is obtained for a content object, it is possible, if supported, to execute tasks on 
the content to send commands or get and set values of properties. 

Querying commands. 

10 

[0612] From the content a reference to the XCommandProcessor is obtained. If it is valid then a reference to the 
XCommandlnfo is obtained and from this the sequence of possible commands. The command names are then printed 
out. 



15 Executing commands. 

[0613] A reference to an XCommandTask is created from the reference to the XCommandTaskProcessor with a 
given command and reference to the XContentTaskEnvironment. If the task is valid then is it executed synchronously 
via the execute method. The resultant object of type any is then obtained via the getResult method. 

20 

Querying properties. 

[0614] From the XContent reference the XPropertyTaskProcessor reference is obtained. If it is valid then the refer- 
ence to the XPropertySetlnfo is obtained via the getPropertySetlnfo method. The sequence of property names is then 
25 obtained from the getproperties method. The property names are then printed out. 

Get value of a property. 

[0615] From the XPropertyTaskProcessor reference an XPropertyTask reference is created via the createproper- 
30 tyTask method and a sequence of properties and a reference to the XContentTaskEnvironment. If the task is valid the 
property is obtained by calling the execute method. Thus the property is obtained synchronously The sequence of 
values is then obtained from the getProperties method. The value of the first property is then obtained in any 
[0616] In the following examples of code sections for canTing out operations of the above embodiments. It is noted 
that the examples are not to be construed as limiting the invention. 

35 



40 



45 



50 
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Content providing 



scheme ://host/path/extra-path-in£o7query- info 



UniversalContentBroker service 

service UniversalContentBroker 
{ 

interface XContentProviderManager ; 
interface XConcent Provider; 
interface XContentldent if ierFactory; 



XContentProviderManager interface 

interface XContentProviderManager : stardiv: :uno: iXlnterf ace 

^ void registerContentProvider( (inl XContent Provider Provider, 
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(in] string Scheme, 
[in] boolean Replace£xi sting, 
[out] XContent Provider Replaced ) 
raises { DuplicateProviderException ) ; 

[oneway] void deregisCerContentProvider ( (in) XContent Provider Provide 

(in] string Scheme ) ; 

ae que nce< Content Pro viderinfo> queryContentProviders [) ; 



XContentProvider interface 

interface XContentProvider : stardiv: :uno: :XInter£ace 

{ 

boolean queryContent ( tii^] XContentldentif ier Identifier. 

lout] XContent NewContent ) ; 

ContentldCompare compareContentlds ( [in] XContent Identifier Xdl. 
20 [in) XContentldentif ier 162 ) , 



25 XContentlndentifierFactory interface 

interface XContentldentif xerFactory : stardiv: :un0: :XInter face 
{ 

XContentldentif ier createContent Identifier ( tin] string Content Id ); 



35 



40 



XConteintlndentifier interface 

interface XContentldentif ier : stardiv: :uno: : XInter face 



void setContent Identifier ( [in] string Contentid ) 

raises ( AlreadylnitializedException. Zllegalldentif ierException ) 

string getContent Identifier () ; 

string getCcntentProviderSchemeO ; 



Getting content from a provider system 



50 
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Reference < XIncerCace > xI^UCB ( 

a^xFac - >crea teXns cance ( 

L^stardiv.one.ucb.UnlveraalContentBroker*} ) ; 
Referencec xConcent Provide rManager > in_xCPM ^ 

References XContentProviderKanager >: '.query ixlJOCB) ; 
Reference< XConc en 1 1 deatifier Factory > m_xCXI)7 ° 

Reference< XContentldencif lerFactory >: -.query (xI_UCB) ; 
Reference < XCont en t Provider > m_xCP • 

Referencec XContent Provider >::guery (jcl_OCB) ; 

Reference < Xinterface> xI^FTPCP ( 

ni__xFac-> create Jnfltance ( 

L**xxx . XXX . XXX . FtpContentProvlder" ) ) ; 
Reference< XConcent Provider > in_xPTPCP « 

Referencec XCoatent Provider yz -.query (xI_FTPCP) ; 

Reference< XContent Provider > xReplacod; 

nj_xCPM- > regis terCon cent Provider (ni_xPTPCP, I^^ftp", oal^False, xSeplaced) ; 

Reference< XContentldent if ier > xCiD » 

xn_xClDP->createConcencJdentifier (L*£tp: //hotne/pauls/") ; 

References XContent > xContent; 

sal_Bool v » m_xCP->9ueryCoiJCenc (xCID, xContent) ; 



XContent interface 

interface XContent : stardiv: :uno: :XInterface 

i 

void initial ire ( (in) XContentldent if ier Indent if ier ) 

raises ( AlreadylnitializedException, Illegalldentif ierException ) 

XConcent Identifier getldentif ier {) ; 

string getContentTypeO 

foneway] void addContentEyent Listener ( 

(in] XContencEventLiatener Listener ) ; 

(onewayj void removeContentEvencListener ( 

(in] XContent Event Listener Listener ) ; 

) ; 

interface XContentEventLiatener : stardiv : :uno: :util : :XEventliiatener 

{ 

void conteaCEvent ( (in] ContentEvent eve ); 

}; 



XlndexAccess interface 

interface XlndexAccess : XElement Access 

/ 

[const] long getCountO; 
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[const) any geCByZndex( [in] long Index ) 

raises ( stardiv: :uno: :lang: : IndexOucOfBounds, 
stardiv: :oae : : lang: :WrappedTargetExeception ) : 



XContentCreator interface 

Interface XContentCreator : stardiv: :uno: iXInterface 

{ 

6eq[uence«ContentIn£o> queryCreatableCoateatsInf oO ; 

boolean createNewContent ( (in] Content Info Info, 

(out! xcontent NewContent ) ; 

boolean insertContent ( (in) xcontent Content ); 



struct Contentlnfo 

{ 

string Type; 
long Attributes 

} 



XCommandTaskProcessor interface 

interface XCommandTaskProcessor : etardiv: :uno: :XInterface 
{ 

XCononandTask createCommandTa3]c{ 

[in] CoTnmand TheCommand, 

[in] XContentTaskEnvironment Environment ) ; 
XCononandlnf o getCommandsInCoO ; 



XCommandlnfo interface 

interface XCommandlnfo : stardiv: :uno: :XInterface 
I 

[const] seguence<ConmLandInfo> get Commands () ; 

[const] Commandlnfo getCommandlnf oByName ( [in] string Name ) 
raises ( UnsupportedCommandException ] ; 

(const! Commandlnfo getCommandlnfoByHandle ( [in] long Handle 
raises ( UnsupportedCommandException ); 

(const] boolean hasCoramandByName ( [in] string Name ) ; 

[const] boolean hasCommandSyHandle ( (in] long Handle ); 



XCommandTask interface 

interface XCommemdTask : XContentTask 



EP1 126 681 A2 



I 

Cotmoand getCocmoand ( ) ; 
any getResultO; 



XPropertyTaskProcessor interface 

interface XPropercyTaskProcesaor : stardiv: :uzio: :beans: tXMulciProperfcySec 
{ 

XPropercyTask createPropercyTask { 

tin] Proper tyTaskType Type, 

tin) sequeace<stardiv: :uno: : beans : :PropertyValiie> Properties, 
[in I XContentTaskEnvironment Eavironmeat ); 

}; 



XPropertyTask 

interface XPropertyTask : XContentTaak 

{ 

Proper tyTaskType getTypei); 
Bequeace<PropertyValue2n£o> getPropercie8( ) ; 

1; 



XContentTask interface 



interface XContentTasX : stardiv: :uno: :XInterface 
{ 

[onewayl void start ( ) ; 

void execute () 

raises ( stardiv: :uno: ; Except ion ); 

(oneway] void abort ( ) ; 

ConcentTaskScatus getStatusO; 

XContentTaskEnvironment getEnvironment { ) ; 



XContentTaskEnvironment interface 



interface XContentTaskEnvironment : stardiv: tuno: iXInterface 

{ 

XContentTaskClient getClientO; 
XErrorHandler gecErrorHandler { ) ; 

1: 



XContentTaskClient interface 
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incerface xConcencTaekClienc : scardiv: :uno: :ucil : iXCventLiotener 
{ 

void contentTaskBvent ( tin] ContentTaskEvenc Event ) ; 



Obtaining children fix>m content 

Reference*: XIndexAccess > xZdx{ 

Reference< XIndexAccess >: :guery{ m_xContent } ); 
sal__ulnt32 nCount » xldx- >9etOount() ; 
if ( nCoxmt ) 

{ 

print ( "Children:" ); 

for { 8al_ulnc32 n « O; n < nCount; ++n ) 

Any aChild = xIdx->getflyXndex( n ) ; 
if < aChild.0etValue1>pe() 

getCppuTypei (const Reference c XContent >*)NULL ) ) 

{ 

const Reference< XContent >* pContent = 

SAL_STATIC_CAST ( const Referencec XContent 
aChlld.getvalueO ); 

Referencec XContent > xContentC *pContent ); 

Reference< XContentldencif ler > xld( 
XContent- >^etldentifier() ) ; 

WString alextt "Xt" ); 

aText xld- >getCt»n ten tiden tif ier O getStrO ; 
aText += " - 

aText += XContent- > get Con t en t rype{ ) ; 
print { aText ); 

} 

) 

) 



Querying commands 

Referencec XCoramandTaskProcessor > xProc( 

References XCommandTaekProcessor >::guery ( x_XContent )); 
if ( xProc.is () ) 

( 

References XCoounandlnfo > .xinfo (xProc->ffetCt>mmand3lnfo() ) ; 
Sequence< Commandlnfo > aCommanda (xInCo->9etCdnimand3{) } ; 
const Commandlnfo* pCosBiiands « aCommands.gecConscArrayO ; 
for {sal_ulnt32 n ^ 0; n < aCosnnands.?etLensrci> O ; ^*'*-) 
{ 

print { pConciands [ n ) .t^ame.gecStri) ); 

1 

» 



Executing commands 
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Reference< XcommandTask > xTask( 

xProc-ycreAteCornaandTaski aCamnwind, xBov } ) ; 
IE ( xTask.is {) ) 
{ 

xTask- > execute ( ) ; 

Any any - xTask.getAesuIt 0 ; 

) 

Querying properties 

Reference*: XPropertyTask Process or > xProc( 

Refereiice< XPropertyTaskProcessor >. -.query [ iQ_xContent )); 
if ( xProc. is {) ) 

{ 

Re£erence< XPropertySetinf o > xlnfo( 

xProc- >getPropercySecXnf o ( ) ) ; 
Sequence< Property > aProps (xinf o->getPropercies() ); 
for (sal_ulnt32 n e 0; n < aProps.getl^ngthO ; n++) 

{ 

orint { aPropst n J .Mame.gretStrO ); 

) 

} 

Get value of a property 



Referencec XPrcpertyTask > xTa8k( 
xProc - > crea te Proper t /Task ( 

PropertyTaskType_GET, aProps, xTaskBnv) ) ; 
if ( xTask.isO ) 

I 

xTask- > execute () ; 

Sequence< PropertyValueinf o > aRe8ults( 

xTask->geCPropercies<) ) ; 
const PropertyValueinf o* pResults = 

aReaulte.getConstArrayO ; 
Any any = pResulta [ 0 ] .Value 

1 

[0617) In the following, embodiments for an individual representation of data will be described with respect to Figs. 
34 - 39. 

[06181 Information requested by a user device naturally needs to be in a format to be understood by this specific 
user device. Therefore. In many instances Information Is only accessible to a certain group of user devices. For example, 
homepages of individuals or companies provided by a webserver over the internet are generally available only to 
specific user devices, namely computer systems supporting the regular homepage data format html. However, the 
access of other user devices to this infomiatlon may also be desirable. Such user devices may be. for example, hand- 
held computers or mobile phones. 

[0619] It is therefore desirable to provide access of data, particularly over a network, to a variety of different user 
devices, including mobile phones and handheld computers. 

[0620] A'method for presenting data on a user device with presentation requirements relating to the presentation of 
this data on the user device, comprises the following steps: 

a) receiving a request from the user device for the data by data presentation management means, 

b) identifying the presentation requirements of the user device to the data presentation management means, 

c) selecting a presentation scheme for the data in accordance with the presentation requirements, so that the 
presentation scheme can be applied to the data to create presentable data to allow the presentation of the data 
on the user device. 

[0621] Herein, the step c) may be carried out by the data presentation management means. The method may also 
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comprise the step d) of applying the presentation scheme to the data to create presentable data to allow the presentation 
of the data on the user device. This step d) may be carried out by the data presentation management means. However, 
step d) may also be carried out by the user device or by any other device which applies the presentation scheme and 
provides the presentable data to the user device. 
5 [0622] The aforementioned method may be supplemented by the further step e) of transmitting the presentable data 
to the user device to allow the presentation of the data on the user device. 

[0623] The data may be retrieved by the data presentation management means before the application of the selected 
presentation scheme to the data. In another embodiment the data may be retrieved by the user device itself. Then, 
the selected presentation scheme may be applied by the user device or by the presentation management means. The 
10 latter would/for example, apply, if the data retrieved by the user device would be transferred to the presentation man- 
agement means for applying the selected presentation scheme and than be re-transferred to the user device. 
[0624] Further, a method may be provided for obtaining data by a user device having presentation requirements 
relating to the presentation of the data on the user device, comprising the following steps: 

15 a) submitting a request by the user device to data presentation management means for obtaining the data from 

the data presentation management means, the request causing the identification of the presentation requirements 
of the user device to the data presentation management means, the selection of a presentation scheme for the 
data in accordance with the presentation requirements of the user device by the data presentation management 
means, the request further causing the application of the selected presentation scheme to the data to create pre- 

20 sentable data, and 

b) receiving in the user device the presentable data to allow the presentation of the data by the user device. 

[0625] Furthermore, a method may be provided for obtaining data by a user device having presentation requirements 
25 relating to the presentation of the data on the user device, comprising the following steps: 

a) submitting a request by the user device to data presentation management means for obtaining the data from 
the data presentation management means, the request causing the identification of the presentation requirements 
of the user device to the data presentation management means and the selection of a presentation scheme for 

30 the data in accordance with the presentation requirements of the user device by the data presentation management 

means, 

b) receiving in the user device the selected presentation scheme for the data, 

35 c) applying in the user device the selected presentation scheme on the data to create presentable data. 

[0626] Herein, the user device may receive the data via data management presentation means, as described eariier. 
[0627] Here, data may be the representation of information. This infonnation can be presented by any suitable means, 
for example, text, picture, sound, movie or action. Different kinds of information can also be combined. This data may 

40 be accessible to the user device, for example, via a networic. For the retrieving of the data certain requirements of the 
user device have to be considered. Such requirements may be of different type. They include presentation require- 
ments. They may further have different origin. For example, the requirements may be caused by the software on the 
user device, which may support only specific kinds of information. It may also be possible that the requirements depend 
of the hardware of the user device, if the user device can. for example, present information merely via a loudspeaker 

45 User depending requirements are also possible within the scope. This may be caused by certain preferences of the 
user as well as by a handicap. 

[0628] Further, data may also include functions. Such functions may be. for example, actions for presenting data, 
for example, movies and sound as well as function for processing on data like, for example, calculation functions or 
spellchecker. 

50 [0629] A user device may be, for example, a computer system comprising at least a processor, a storage medium 
and an i-/o-interface. Via this i-/o-interface the user device may be connected to the source of the data. It will also be 
possible that the requested data is stored on the storage medium of the user device. Regularly, the user device com- 
prises also input and output devices connected via the i-/o-interface. 

[0630] The requested data may be retrieved via at least one portlet. In this context a portiet may be understood to 
55 be means for providing the requested data from a data source, for example, from a certain homepage or data base. 
[0631] Two or more portlets may be arranged in tree-like organization. This tree-like organization may be presented 
to a user of the user device, for example, on a screen of the user device, so that this user has the possibility to easily 
choose among the offered portlets. 
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[0632] The presentation requirements of the user device may be determined based on infomnation about the user 
device. For example, if the data presentation management means are informed about the type of the user device they 
may conclude therefrom the presentation requirements of the user device. 

[0633] In the present context data presentation management means are hardware or - generally - software means 
5 for managing the presentation of data on a user device. Their exact functionality depends on the implementation. The 
functionality of the data presentation management means includes at least the selection of the presentation scheme 
for the requested data in accordance with the presentation requirements of the user device. For this purpose the data 
presentation management means must be informed about the presentation requirements of the user device. Further- 
more, the functionalities of the data presentation management means may include the application of the selected 
10 presentation scheme on the requested data in. order to create presentable data to be presented by the user device. 
This requires the availability of the requested data for the data presentation management means. The retrieval of this 
data may also be carried but by the data presentation management means. 

[0634] The presentation schemes may be defined, for example, in an extensible stylesheet language (XSL). XSL is 
a language for creating a stylesheet which describes how content being fomnatted in an extensible maricup language 

15 (XML) will be presented to a user device. The presentation scheme may describe, for example, if a certain content 
defined in XML will be displayed, where this content will be displayed and how it will be displayed. 
[0635] The above methods may be implemented In a computer program (computer program product), including com- 
prehensive office applications. A computer program product comprises a medium configured to store or transport 
computer readable code, or in which computer readable code may be embedded. Some examples of computer program 

20 products are: CEVROM disks. ROM-cards, floppy disks, magnetic tapes, computer hard drives, servers on a network 
and earner waves and digital isignals transmitted over a telecommunication link or network connection. 
[0636] Such a computer program may be stored ori any common data carrier like, for example, a floppy disk or a 
compact disk (CD), as well as on any common computer system's storage facilities, like hard disks. A data carrier may 
store a coniputer program for carrying out the above operations and a standard computer system may be used for 

25 carrying out the above operations. 

[0637] A computer system may be provided comprising at least a processor, a memory and an i-/o-interface for 
representing data depending on presentation requirements of a user device relating to the presentation of the data on 
the user device, comprising data presentation management means, wherein the data presentation management means 
include: 

30 

a) at least one receiving module for receiving a request of the user device for the data, 

b) at least one identifying module for identifying the presentation requirements of the user device, and 

35 c) at least orie selecting module for selecting a presentation scheme for the data in accordance with the presentation 

requirements. 

[0638] Furthermore, the computer system may comprise 

40 d) at least one retrieving module for retrieving the data, and 

e) at least one applying module for applying the selected presentation scheme to the data to create presentable 
data which may be presented by the user device. 

45 [0639] The retrieving and the applying functions may also be carried out in a user device or in a computer system 
being accessible to the user device. Therefore, the retrieving module and the applying module may also be located in 
the user device or in any computer system which is connectable or conntected to the user device and which is able to 
deliver the result of the application of the presentation scheme, the presentable data, to the user device. 
[0640] The aforementioned computer system may be supplemented by a transmitting module e) for transmitting the 

50 presentable data to the user device to allow the presentation of the requested data on the user device. 
[0641] In the following, an embodiment will be described with respect to Fig. 34. 

[0642] Fig. 34 shows an example of a system and method for the individual representation of data. A user device 
like a mobile phone 3401 A or a laptop computer 3401 B may want to access certain data via the networic 3402. This 
network 3402 may be the Internet or any other permanent or terriporary network, for example a local area network. 
55 Other user devices are suitable as well. Examples Include any kind of computer systems, like servers and personal 
computers, and any devices which are able to process data and to communicate with other devices for exchanging 
data. In this context computer systems may include at least a processor, a storage medium and an i-/o-interface. In 
this context data refers to any type of information which is arranged in certain order to be accessible by a computer 
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system. The data to be accessed may also include one or more functions or functionalities provided to the user of a 
user device. Functions are. in this context possibilities given to the user device to initiate any actions beyond the mere 
retrieval or display of infomnation, for example, a search In the internet for a certain publication or the initialization of 
a software program on a remote server carrying out some operations in response to the user device's request 
5 [0643] If the user device 3401 A or 3401 B wants to access certain data via the network 3402, It will send a request 
for said data, for example, for a certain homepage, to a webserver 3403. The webserver 3403 comprises a processor, 
a memory and an i-/o-interface. 

[0644] In particular, the webserver 3403 includes means for receiving this request. The request may specify the data 
requested from the mobile phone 3401 A or the laptop 3401 B by giving suitable address data as to where this data can 
10 be found, for example, the Internet address of a homepage (URL). 

[0645] This request will t>e forwarded to data presentation management means, in the following exemplary referred 
to as portlet manager 3404. This portlet manager 3404 may be implemented in software within the webserver 3403 or 
may be installed on a separate computer system which is connected or cbnnectable to the webserver 3403. Having 
received the request for data from the webserver 3403 the portiet manager 3404 identifies the presentation requi re- 
is ments of the user device having sent the request for the data with respect to the presentation of the data to this user 
device. For this purpose the user device has means for identifying these requirements. These presentation require- 
ments may be any conditions or limitations for the presentation of data on the user device, for example, kind and size 
of display for data on the user device, type of programming language or data format supported by the user device, or 
any other presentation requirements of the user device, for example, of the processor or the memory. These presen- 
ce tation requirements may not only result from technical necessities, but also from an individual user's demands or 
wishes. The presentation requirements of the specific user device are identified by the respective means either by 
being provided the information about the presentation requirements directly from the user device, together with the 
request for the data or separately, or by being provided infomnation about the type of the user device and by procuring 
the needed information about the presentation requirements of the so identified user device from a data base, which 
25 may or may not be an integral part of the portlet manager, and which connects information about the type of the user 
device with the desired information about the specific presentation requirements of the user device with respect to the 
presentation of the requested data. 

[0646] In order for the data to comply with the identified requirements the portlet manager 3404 loads all configuration 
information needed for presenting the requested data to the user device 3401 A or 3401 B, respectively. Configuration 

30 information is all information about the layout and the presentation of the requested data. It must correspond to the 
identified requirements. The totality of the configuration information needed to present data to a certain user device is 
referred to as a presentation scheme. This is selected according to the presentation requirements of a certain user 
device by the data presentation management means, i.e. the portlet manager 3404. For this purpose, XSL-stylesheets, 
which may be stored in storage medium 3405 may be selected according to the identified requirements by means 3407 

35 for presenting data in accordance with the identified presentation requirements of the user device 3401 A. These means 

3407 are generally implemented in software. They may, for example, have access to a further external storage medium 

3408 on which, for example, XSL-stylesheets may be stored. The configuration data loaded in response to the user 
device's request may be stored in a specific file until the data to which it shall be applied has been provided. 
[0647] The portlet manager 3404 now retrieves the requested data. The data is procured via the webserver 3403 

40 from portlets 3409, 3410 Portlets 3409, 3410, ... represent ways for accessing the requested data. This data may 

have different format. For example, text based infonnation may be provided in the HTML fomnat as well as in the WML 
format, The portlets 3409, 3410, ... have means for accessing data, including software modules, to retrieve the re- 
quested data for the portlet manager 3404 from any accessible location, including internet homepages, data bases 
and other storage media. 

45 [0648] In the portlet manager 3404 the means 3407 will then apply the presentation scheme loaded from storage 
media 3405, 3406 and 3408 to the data. This presentation scheme will be applied to the data. Herewith, the data which 
was requested by the user device 3401 A or 3401 B, respectively, is converted to presentable data which may be pre- ? 
sented in accordance with the requirements of the user device 3401 A or 3401 B, respectively 
[0649] Finally, the data may be transferred to the user device 3401 A, 3401 B which requested it in the presentation 

50 required by this user device 3401A, 3401B. Herewith, the user device 3401A, 3401B may access the requested data 
in proper form. 

[0650] Fig. 35 gives an example of a user's view by showing a print-out of a screen 3520 of a user device, here a 
laptop. Screen 3520 shows symbols 3521, 3522, 3523, .... each standing for one portlet - 3409, 3410, ... in Fig. 34. 
The symbols 3521. 3522, 3523, ... offered on the screen 3520 and the portlets associated therewith can be freely 
55 chosen by a user of the user device. 

[0651] However, a portlet is only selected for display on screen 3520, that means the user can only choose it, if its 
data may be presented by the user device. For example, if the user device does not support graphics, a portlet which 
defines the MIME type image/jpeg will not be selected for display on the screen 3520, that means it will not be offered 
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to the user of the user device. This pre-selection of portlets to be offered to the user is made by a comparison of the 
requirements of the user device and of the MIME type of data defined by each of the portlets. In the above example 
relating to graphics the presentation requirements of the user device, the laptop, regarding the presentation of data 
will not allow to support graphics. The comparison with the MIME type of data defined by the various portlets will show 
5 that a portlet defining image/jpeg as its MIME type of data cannot be supported by this user device. Therefore, it will 
not be displayed on the screen 3520. This comparison may be made at any suitable location, for example, in the user 
device as well as in the websen^er, in the portlet manager or in the respective portlet itself. 

[0652] Instead of the screen print-out given in Fig. 35 the portlets may also be offered to the user of the user device 
in the form of a text based listing. This listing may be put together in the portlet manager, for example, in the XML 
10 format. The information required for this listing, namely which portlet defines which mime type of data, may be retrieved 
via the webserver from the various portlets. 

[0653] Fig. 36 shows in a flow chart one possible way to fulfill the presentation requirements of the user device 3401 A 
or 3401 B, respectively. In a first step 3601 the user device 3401 A. 3401 B sends a request to the portlet manager 3404 
via the webserver 3403. This request either contains information about the presentation requirements of the requesting 

15 user device 3401A, 3401B or it contains infomiation about the identity of the user device 3401A, 3401B. It further 
includes a description of the requested data. Such a description may be, for example, the URL of the data, if the 
requested data can be found on a homepage on the Internet The portlet manager 3404 will contact in step 3602 the 
corresponding portlet for retrieving this data. If the requested data is only available from several different portlets, those 
would be contacted in this step. In a next step 3603 the porttet manager 3404 retrieves the data from the one or more 

20 portlets. In order to consider the presentation requirements of the user device 1 the portlet manager 3404 needs in- 
fomiation about these requirements. In one emtrodiment the portlet manager 3404 extracts from the request in a further 
step 3604 a list of MIME types supported by the user device 3401 A, 3401 B. In another embodiment the portlet manager 
3404 may have a list of the presentation requirements of different user devices 3401 A, 3401 B. In this case, the portlet 
manager 3404 may analyze the identity of the user device 3401 A, 3401 B in step 3605 and then contact this list in step 

25 3606 in order to obtain the information about the requirements of the user device 3401 A. 3401 B. 

[0654] Fig. 37 shows a flow chart representing for presenting data on a user device with certain data presentation 
requirements. In a first step 3701 the data presentation managemeJnt means, i.e. the portlet manager 3404 receives 
a request for data from a user device 3401 A, 3401 B. In the next step 3702 the portlet manager 3404 identifies from 
this request the presentation requirements of the user device 3401 A, 3401 B, as it was above described in relation to 

30 Fig. 36. In step 3703 a presentation scheme is selected for the requested data in accordance with the identified pres- 
entation requirements. This enables the user device 3401 A, 3401B or the portlet manager 3404 or another computer 
system which is able to be connected to the user device 3401 A, 3401 B or to the portlet manager 3404 to apply the 
selected presentation scheme to the data delivered by the portlets in order to anive at presentable data which may be 
presented to the user device 340 1 A, 340 IB. 

35 [0655] Fig. 38 presents an exemplary embodiment with a setup as presented in and described in connection with 
Fig. 34 is used. Therefore, reference numerals below 3800 refer to devices shown in Fig. 34. 
[0656] In step 3800 the user device, for example, a mobile phone 3401 A sends a request for data via the networic 
3402 to the websen^er 3403. The mobile phone 3401A uses the wireless application protocol (WAP) as MIME type for 
data which it handles and processes. A browser may run on the mobile phone 3401 A. The requested data may be, in 

40 this example, a certain homepage which is available on the Internet at a certain URL. This homepage is programmed, 
for the purposes of this example, in an extensible markup language (XML). The request of the mobile phone 3401 A 
includes at least the URL of the requested homepage and the MIME type supported by the mobile phone 3401A, i.e. 
WAP. In this example, the identity of the user device 3401 A, 3401B and its user is transmitted together with or as a 
part of the request The request also includes a command, for example, "channel", if the content of the requested URL 

45 shall be loaded onto the user device. 

[06571 step 3801 this request of the mobile phone 3401 A is analyzed by the websen^er 3403 in order to decide 
whether this request has to be processed by the portlet manager 3404. The altemative is to provide the data directly 
by the webserver 3403. This decision - made in step 3802 - is based on the MIME type used for the requested homepage 
and the MIME type supported by the mobile phone 3401 A. 

50 [0658] If the above question would be answered with "NO", then the requested data will be directly provided by the 
websen^er 3403 to the mobile phone 3401 A in step 3803. This would require that the MIME type of the requested data 
and the MIME type supported by the mobile phone 3401A are identical or at least compatible. This condition will 
frequently be fulfilled, for example, if a browser - which is able to handle and process data in XML - requests a homepage 
- which is also formated in XML. 

55 [0659] If the answer to the above question is "YES", the request is forwarded by the webserver 3403 to the portlet 
manager 3404 in step 3804. The portlet manager 3404 may be a servlet. A servlet is an extension to a webserver 
which provides the webserver with information and logic. If a request for a certain URL, for example, is forwarded to 
the portlet manager 3404. the portlet manager 3404 is started. This leads to the portlet manager 3404 processing the 
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request. This processing includes doPost requests as well as doGet requests as It is shown in Table 1. In order to 
simplify the further communication the portlet manager 3404 employs the URL mentioned in the request forwarded by 
the webserver 3403 for identifying itself and saves this address in a string. The portlet manager 3404 identifies also 
the requested command. In one embodiment there are supported at least the following commands. The ^oarf' com- 

5 mand toads information about the requested data. With the "save" command the user device submits settings made 
by the user device 3401 A in order to save these settings along with the user data. In order to pnsvide the content of a 
portlet to a user device the "channel" command Is submitted. Since the user device 3401 A requests in this example 
data from a portlet the "channel" command will be submitted by the mobile phone 3401 A. The functionality of the portlet 
manager 3404. especially certain commands, is described in detail in the code shown in Table 1. 

10 [0660] In step 3805 the identity of the user device 3401 A and of the user employing the user device 3401 A is retrieved 
from the request Then, in step 3806, the portlet manager 3404 will access an internal or external storage medium, for 
example, data base 3408 in order to check whether for the identified user device 3401 A and for the identified user a 
presentation scheme or parts of a presentation scheme are already stored. For example, a certain user may request 
a specific character type (font) for the data to t>e presented on the display of his mobile phone 3401 A, or a certain 

15 mobile phone 3401 A may request a specific character size (font size) in view of its specific display 

[0661] If "NO", that means the storage medium does not have any infomnation about a presentation scheme or a 
part of a presentation scheme assigned to the specific user or the specific requesting user device 3401 A, the portlet 
manager 3404 may search in step 3807 in the network 3402 for such individual presentation schemes or parts thereof. 
For example, if the network 3402 is the Intemet the portlet manager 3404 may contact the homepage of the producer 

20 or distributor of the mobile phone 3401A in order to find the desired information there. If the search of the portlet 
manager 3404'is successful, the presentation scheme or part of a presentation scheme will be retrieved in step 3808. 
If the search is not successful, a default presentation scheme will be provided for later application to the requested 
data in step 3809. 

[0662] If "YES", that means the storage medium has information about a presentation scheme or a part of a pres- 
25 entation scheme assigned to tiie specific user or the specific requesting user device 3401 A, the portiet manager 3404 
loads this presentation scheme or part thereof in step 3810. 

[0663] In step 61 . based on the presentation scheme or part thereof retrieved and based on tine request of the user 
device 3401 A the portlet manager 3404 requests from one or more portiets 3409, 3410. ... the delivery of the requested 
data, here the homepage with the URL specified in the request of the user device 3401 A. This request includes a list 

30 of all MIME types which are either supported by the user device 3401 A or which may be converted by the portlet 
manager 3404 into a MIME type which is supported by the user device 3401 A. Other additional information like, for 
example, the type of the browser used by the user device 3401 A may also be included in the request to the portlet. In 
step 61 the portiet manager 3404 asks the portiets 3409. 3410 ... whether they are able to deliver the requested data 
in a MIME type listed in the request. In order to submit the request it may be necessary to create a connection to the 

35 portiet. 

[0664] If "NO", that means if the data cannot be delivered by the portiets 3409. 3410, ... in a MIME type which is 
supported by the user device 340 1 A or which can be converted by the portiet manager 3404 into a M I M E type supported 
by the user device 3401 A, an error message is created in step 3812, which is sent to the mobile phone 3401 A in order 
to report that ttie request for data sent in step 3800 to the webserver 3403 cannot be fulfilled. 
40 [0665] If "YES", that means if the data can be delivered by the portiets 3409, 3410. ... in a MIME type which is 
supported by the user device 3401 A or which can be converted by the portlet manager 3404 into a MIME type supported 
by the user device 3401A, the data are received by the portlet manager 3404 in step 3813. In step 3814 the MIME 
type of the received data is analyzed as to whether the user device 3401A supports it or conversion by the portiet 
manager 3404 is necessary. 

45 [0666] If no conversion is necessary, the requested data are transferred to the user device 3401 A directly via the 
webserver 3403 and the networic 3402 in step 3815. If, however, conversion is required, what wilt be the case in our 
example where the homepage is in XML and the mobile phone 3401 A supports only WAP. tine retrieved data will be 
analyzed in step 3816 as to whether it is present in an extended markup language (XML). 

[0667] If "NO", that means if the requested data Is not in XML. the data will be converted in step 3817 into the 
50 requested Ml ME type to arrive at presentable data by applying the corresponding presentation scheme, which includes 
conversion modules for the conversion of data between the respective MIME types. If, for example, the requested data 
would be supplied in HTML, this data would be converted from HTML to WAP in step 3817. Subsequently the created 
presentable data is sent to tiie user device 3401 A in step 3815. 

[0668] If "YES", that means the data is in XML - like in the here chosen example - the portiet manager 3404 will 
55 select the suitable presentation scheme. For XML data this presentation scheme may include a XSL stylesheet. If a 
user device specific presentation scheme is accessible, the portlet manager 3404 will choose this. 
[0869] The requested data will tiien be subjected in step 3818 to ttie application of the presentation scheme, in tiiis 
example, to the selected XSL stylesheet. The presentation scheme may be retrieved by portlet manager 3404 from 
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storage medium 3405. Herewith, the presentation scheme - here: the XSL stylesheet - is applied to the data so that 
presentable data is created. This presentable data may be sent to the user device 3401 A in step 381 5. 
[0670] Fig. 39 shows an example of a portlet manager 3404. The portlet manager 3404 comprises in this example 
six modules. Module A is a receiving module for receiving a request of the user device 3401 A, 3401 B. Module B is an 

5 identifying module for identifying the presentation requirements of the user device 3401 A, 3401 B. These two modules 
are able to communicate with the selecting module C in order to enable module C to select a presentation scheme for 
the requested data In accordance with the presentation requirements of the user device 3401 A, 3401 B. 
[0671] In the present example, the portlet manager 3404 comprises also a retrieving module D for retrieving the 
requested data to the portlet manager 3404. The applying module E will then apply the presentation scheme selected 

10 in module C to the data to create presentable data which may be presented by the user device. This presentable data 
will be submitted by a transmitting module E to the user device. The modules D, E and F need not be part of the portlet 
manager 3404. They or some of them may also reside on the user device 3401 A, 3401 B or on a computer system 
connected to the user device 3401 A, 3401 B or to the portlet manager 3404. 
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Table 1; 

public class PortletManager extends HttpServlet 
{ 

This method provides information about a servlet used as portlet manager to a user 
device. In this example the method returns the name of the servlet and a copyright notice, 

public Scring getSecvletInf o() 
{ 

return "Channel Manager - Copyright 2000 Sun Microsystems. Inc."; 

) 

This method is called when the webserver (HTTP server) loads the servlet^ It is only called 
once for the purpose of initialization. In this case configuration path names are loaded to 
the XSL and XML files. 

public void init (ServletConfig configuration) 
throws ServletException 

{ 

System. out .println (getServletlnCoO ) ; 
super. init ( configuration ); 

in_aServletContext = conf iguration.getServletContext ( > ; 

m_aServietContext - gecServletContext ( ) ; 

String sRootBase « null; 

Stcing sXslBase « null; 

String sUserBase - null; 

String sNoUserName ~ null; 

try 

{ 

sRoocBase « new string (getlnitParamcter {"rootbase-uri") ) ; 
sXslBdse = new String (getlnitParaineter ("xslbase-uri") ) ; 
sUserBase - new string (getlnitParametet ("userbase-uri") ) ; 
sNoOserName = new String (getlnitParameter Cnouser-name") ) ; 

) 

catch ( Exception e ) 
{ 

System. ett .printing "some required init parameter is 



missing** ) ; 



throw new ServletException Cinit parameter missing"); 



) 

The doPost method is called every time a HTTP post request arrives at the webserver with 
a request for an URL for which the servlet was configured initially Post requests are 
handled in the same method where get requests are handled, so the doGetQ method is 
called. 

public void doPostt HttpServletRequest request, 

HttpSetvletResponse response ) 
throws ServletException, lOException 

( 

doGet (request, response); 

> 



121 



EP 1 126 681 A2 



The doGet method is called every time a HTTP get request arrives at the webserver with a 
request for an URL for which the servlet was configured, 

public void doGet t HttpservletRequesc aKttpservletRequest, 

HttpServletResponse aHttpServlet Response ) 
throws ServletCxception, lOException 

{ 

try 
{ 

A string is formed which specifies the URL of the servlet based on the information coming 
with the request. This string can later be used to specify the servlet as target for a HTTP- 
request. This will be done once, because this URL can only change if the configuration of 
the webserver will change. In the latter case the servlet would be unloaded and loaded 
again. 

// do it only once 

if (m sPrefixPath.length()«0) 

{ 

// build prefix path (e.g. 

www. sun.com: 8088/portal/CM/)' 

String sHostKame « 
String sContextPath « 
String sServletPath = 

// get host name part 

sHostName aHttpServletRetiuest . getHeader ('"Hosf) ; 

if ((sHoscName =- null) 11 (sHostName. length {) =« OM 
{ 

SHostName •= 

aHttpServietReques t . getServerName ( ) + 

":'* + aHttpServletRequest .getServerPortO ; 
) 

sContextPath » getContextPath (aHttpServletRequest, 

new Object [01 ) ; 

SServletPath « aHttpServletRequest.getServletPathO ; 
// get servlet path part 

m_6PrefixPach = "http;//" + sHostName + sContextPath; 
m_aDataFacade . setContextPath (ni_sPref ixPath) ; 
m_sPref ixPath +- sServletPath; 
// concat 

ra_aDacaFacade . setPrefixPath im^sPreCixPath) ; 
// set path on DataFacade 

m_aComniandFactory « new CommandFactory ( ) ; 
// new conanand factory 

) 

The actual work for resolving the request is done by separate objects. For each command 
specified in the URL given in the request a new object is instanced which is responsible to 
resolve the request. This approach is based on a design pattern called the Command'*- 
pattern. In the current realization there are the commands Joad*\ „save'\ .^article" and 
^.channel". The object associated with each command is instanced by the class 
CommandFactory. 

// get command pattern and execute 
command aCcmmand * 

m_aCommandFactory . produceCommand ( aHttpServietReques 1 1 ; 

aCcmiTiand . execute (aHt tpServletRequest , aHt tpServletResponse, 
m aOataFacade) ; 

) 

catch (Exception e) 
{ 

e.printStackTrace( system. out) ; 

) 
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private ChannelHook m^aChannelHook • null; 

private Command ractorym^^aCommamlFac to ry null; 
private Data Facade m_aDat a Facade • null; 

private ServletContext m_^aServletContext • null; 
private String " m_sPrefixPath • 

The class Comma ndFac to ry parses the head of the specified 
URL for the request for a command, e.g. ^channel"^. If a 
known command is recognized the associated command object 
will be created. 



public class Command Factory 

{ 

public Command produceConimand(ServletReque3t aRequest) 
throws ServletException 

{ 

Command aCommand = null; 
15 String sOrl « null; 

The following method makes sure that this is an HTTP- request and gets the URL out of the 
request 



if (aRequest instanceof HttpServletRequest ) 
( 

HttpServletRequest sHttpServletRequest - 

(HttpServletRequest) aRequest; 
sUrl sHttpServletRequest.getPathlnfoO ; 



else 
t 



throw new ServletException ( 

"Request is not of type HttpServletRequest" }; 



The following method tries to recognize the recent command by comparing the head of the 
URL with the known set of commands. If a known command « found the associated class 
is instanced and this instance is returned to the caller. 



// careful: sort order of if clauses is important 

if( sUrl !« null ) 

{ 

if( sUrl.start5With(CKANNEL) 1 
1 

aComniaiid = new ChannelCoiamand { ) ; 

35 } 

iff sun. star csWitht ARTICLE) ) 
{ 

aCommand new channelCommand ( ) ; 

) 

else if( sOrl.stattsWith(LOAD) ) 

aComraand * new LoadCoiTimand( } ; 

} 

else if( sOrl.start5Mith{SAVE] 1 

{ 

aCommand *> new SaveCommandt ) ; 

System. out .println("- new SaveCommand*') ; 

1 

45 } 

iff aCoimnand " null ] 
I 

throw new ServletException ( 

"Factory cant produce command for URL** + sOrl 

); 

50 ) 



return aCommand; 



public final static String LOAD «= "/load"; 

public final static String CHANNEL = "/channel" 
55 public final static String ARTICLE « "/article" 



123 



EP 1 126 681 A2 



public final static String SAVE » '/save**; 

I 

The ChannelCommand has to provide the content of a portlet as a response to a request. 
The ChannelCommand is derived from the class Command, which is necessary, because of 
the use of the Command'' -pattern. 



public class ChannelCommand extends Command 



{ 



public void execute! ServletRequest aRequest, 

ServletResponse aResponse, 

DataFacade aDataPacade) 
throws Servlet£xception 



K 

InputStream 

InputSource 

InputSource 

URLConnection 

String 

String 

aRequest . get Parameter ( **href" ) 
String 



aRequest -get Parameter ("Mime" 
String 
String 
String 
String 
Hashtable 



aDocInputStreazD 

aDoclnputSource 

aTcansInputSource 

aURLConnection 

sSessionId 

s Encode dURL 

5 Pr e f er redMimeType 



null; 
null; 
null; 
null; 

getSessionld (aRequest) ; 



sOevice = 
sXSL 

sDecodedURL 

sResponseContent 

aXSLParameters 



aRequest. getParameter ("Device") ; 

* aRequest.getParameter (-XSL'M ; 



« new HashtableO; 



try 
( 

// no portlet is specificed in the URL information about all available portlets is returned. 
This will be decided by checking the URL for any additinal information. The information 
about all available portlets will be received from a data container called DataFacade. 
This concept is based on the design pattern Facade. 

//set URL for root channel list 
if t (sEncodedORL— null) I) 

tsEncodedURL. equals ("") ) | | 

(sEncodedURL. equals ("root") ) ) 

( 

SDecodedURL = aOataFacade.getRootBase ( ) ; 

) 



else 
( 



SDecodedURL « U RLD e coder .decode (s Encode dURL) ; 



The part in the URL which specifies the Portlets is an URL which can be used to retrieve 
the content of the Portlet. This will be used to build a corresponding URL object which 
will be used later on to build an URLconnection. 



//get URL connection 

URL aURL - new URL (SDecodedURL) ; 



aURLConnection » aURL.openConnection () ; 

aURLConnection . setUseCaches ( false ) ; 

aXSLParameters .put ("ProviderURL", aURL. toString ( ) ) ; 

In the following method all additional fields which are specified in the request will be 
copied to the new request. These fields can include, for example, the name of the browser 
used on the client side, that means in the user device. 

// tunnel properties 

java.util. Enumeration aHeader Name List « 
( (HttpServletRequest) 

aRequesL) .getHeaderNames () ; 



124 



EP1 126 681 A2 



while (aHeadecNameList.hasHoreGleioents { ) ) 
{ 

String sKey - (String) 

aKeaderNameList .nextClement () ; 

String sValue « ( (HttpServletRequest) 

sRequest) .getHeade^(sKey}; 
aURLConnection.setRequestProperty (3Key, sValue) ; 

) 

The additional MIME types which are supported by the portlet manager will be added to a 
list of accepted MIME types and this list will be added to the new request. 

// sec own nditifi types, because some devices accept some 
// mime types which make them crash... 
String sSupportedHimeTypes » 

aDataFacade .gets upper tedMimeType a (sSessionld) ; 
aURLConnection . setRequestProperty ( "accept* , 

sSupportedMimeTypesl ; 

The provider of the portlet content will be connected and the respective content will be 
read out by using an InputStream 

ft get connection to URL 
aORLConnection-Connect () ; 

InputStream aProviderResponse = 
aUPi.Connection.yetInputStr€am() ; 

In case of a HTTP connection the information in the HTTP header can be used to 
recognize the MIME type of the response, if the HTTP protocol is not used, the extension 
of the specified URLwill he checked. 

if ( aURL.getProtocolO .equals Chttp") ) 
{ 

// get content type 

sResponseContent - aURLConnec tion.get Con tent Type () ; 

} 

else 
( 

///; is recognized that a XML file is requested, it is tried to guess which kind of XML file it 
is by analyzing the DOCTYPE field in the header of the XML file. In the case that an XML 
file based on a certain DTD will be recognized the response type will be set to the 
associated name, 

// protocol is not http, so get content via file 
if {sDecodedURL-endsWithC .xml") ) 

//seems to be an ml file, so get doctype 

co.itent 

aProviderResponse. mark (1024) ; 
byteCl aBuffer « new byte [1000); 
aProviderResponse . read (aBuffer) ; 
aProviderResponse . reset ( ) ; 

String aSearchString = new String (aBuffer) ; 

int nDoctypePositlon « aSearchString. indexOf ( 

-<! DOCTYPE •') ; 

if (nD6ctypePosition==*-l) 
( 

//unknown xml, send as binary 
sResponseContent ■» 

) 

else 

// found "doctype", determine doctype 
String aTokenizerFeed « 

aSearchString . substring <nDoctypePosition) ; 
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aToJcenizer .nextToken () ; 



StringTokenizer aTokenlzer - new 

StringTokenirer (aTokenirerFeed, 



'// get doc type 
aTokenizer.nextToken O ; 



"text/vnd. sun. xna. Channel s"; 



"Lexc/vnd. sun.^aIa.Articie"; 



String sResult » 



if (sResult. equals ("Channels* n 
sResponseContent - 



else if (sResul t. equals ("•Article") ) 
sResponseContent - 



Ise 



//unknown xml, send as binary 
sResponseContent = 



) 

else 
{ 

ffit is not a XML file, the class URLconnection will guess the content type of the response 
stream. 

//no ml £lle« so start guessing 
SResponseContent = 

aURLConncction .guessContentTypeFroraStream ( 

a Provider Response) ; 

if (sResponseContent—null) 
( 

//okay, now I'm helpless 
sResponseContent-" " ; 

1 



40 
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aXSLParameters -put [ "Provider MiraeType" , sResponseContent ) ; 
// xrol response? 

if ( '.SResponseContent .startsWith("text/vnd. sun. xml.") ) 

{ 

!f the response content is not in a XML format handled by the portlet manager, the 
response is returned as response to the original request without any modification. 

// upps, no xna, so simply tunnel through as raw data 
aResponse . setContentType ( sResponseContent ) ; 



if (aResponse instanceof HttpServletResponse) 



( 



aResponse) . setDateHeader I 
Syscem.currentTimeMillisO ) ; 



( (HttpServletResponse) 
-Last-Modified**, 



The inputstream of the response is copied to the outputstream of the response of the 
original request. 



aProviderResponse ; 



Inputstream aURLConnectionlnStream 
Outputstream aResponseOutStrean 
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// it no .xsl extension* add one 

if (sXSL.indexOf 1) 

{ 

3XSL « 5X31*+". xsl"; 



10 



15 



20 



25 



The path to find the XSL stylesheet file is built. First, a device specific file is searched for 
in a subdirectory with the name of the device. If this file is not available, the more generic 
device independent stylesheet is used, 

// build first chance path to xsl file 

ORL aTempORL « new ORLtaOataFacade . getXSLBase O ) ; 

String sXSLBase « aTen^URL.getFile t ) ; 

String sSubMime - sPre^erredMimeType. substring! 

sPreferredMimeType .indexOf ("/") +1) ; 

File aXSLMiiiie » new File (sXSLBase , sSubHime) ; 

File aXSLOevice « new File (aXSLMime, sDevice) ; 

File aXSLFull « new File (aXSLDevice, sXSLi ; 

if ( laXSLFull. exists () ) 
{ 

ft first chance xsl file not there build 
// second chance (no device specific 



transformation) 



raXSLFuli . getAbsolutePath ( ) + 



aXSLFull =« new File (aXSLMime, sXSL) ; 

if (! aXSLFull. exists n> 
{ 

// no xsl found error 
throw new ServletException t 

" file not found!**); 



30 



All the objects needed to parse XML-documents and for the XSL transformation are set up. 
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VaiidatingParser (true) ; 
XmlDocumentBuilder () ; 
VaiidatingParser { false ( ; 
XmlOocumentBuilder () ; 
XSLTransformEngine ( ) ; 



// build parse environment 
VaiidatingParser aValParser 



XmlDocximentBuilder aValDocBuilder 

new 



VaiidatingParser 



aParser 



XmlDocumentBuilder aDocBuilder 

new 

XSLTransformEngine aTrans former « 

new 



Xntl Document 
Xml Document 
Xml Document 



aSourceDoc ^ null; 

aTrans former Doc = null; 
aDrainDoc » 

new XmlDocumentO i 



// hoo)c own entity resolver for finding dtds 
XMLResolver aXMLHesolver « new XMLRe solver (true) ; 
aXKLResolver . legisterCatalogEntries ( 



"com. sun. scar .portal .channel .dtd") ; 



// get/config parser and builder 
aVal Doc Builder . setParser (aValParser ) ; 
aValParser.5etEntityResolver(aXMLResolver) . 
aValDocBuilder . setDisableName spaces ( false) ; 
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aResponse.getOutputStreamO ; 

byteU aBuffer « new byte [1024] ; 

int iReadLength » 0; 
int iReadLengthSum = 0; 

while ( (iReadLength- 

(aUHXXTonnectlonlnStream. readlaBuf £er) ) ) ) - 

{ 

a Re s pons eOut St re am. write (aBuffer, 0, iReadLength) ; 

iReadLengthSum +- iPeadLength; 

) 



// unfortunat^y available () not possible, 

// so I have to use a buffer and set filelength at 

last 

15 aResponse . setContentLength t iReadLengthSum) ; 

aResponseOutStream. flush { ) ; 
return; 

} 

else 

20 { 

// no preferred MIME type, device type or XSL-stylesheet specified with the request exists, 
the associated default type is used. 

// yes, so build path for xsl file which generates 

response 

^, if C (sPreferredMiineType=*null) 1 1 

(3PreferredMlmeType.length()»«0) ) 

// no mime parameter set so get it 
// via portal servlet 
sPref erredMimeType « 

aDataFacade .getPref erredMimeType (sSessionld) ; 
I 

if 1 (sDevice="nulll I! (sDevice. length ()==0) ) 
{ 

// no device parameter set so get it 
// via portal servlet 
sDevice *= 

aDataFacade . getDeviceName (sSessionld) ; 

) 



if ( (sXSL— null) 11 (sXSL. length ()*-0) ) 
< 

If channels are processed, the channel sytlesheet is used, if articles are processed, the 
40 article stylesheet is used. 

// no XSL parameter set so get via content 
String sSubMirae = 

sResponseContent . substring (17) ? 

if ( 3 SubMime.equa Is ( "Channels" ) ) 
( 

45 sXSL "Channels-xsl"; 

} 

else if ( sSubMime, equals ( -Art icle" ) ) 
{ 

SXSL - "Article. xsl"; 

1 

else 

50 ( 

throw new ServletExceptioni 

**+++ no correct xsl type!!!*); 

I 

} 

else 
( 

55 If a XSL parameter is specified with the request, this stylesheet is used. 
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aDocBulIder . setParser (aParsec) ; 

aParser . setEntityResolver t aXMLResolwer > ; 

aDocBuilder.setDisableNamespaces (false) ; 

Parse the received response as an XML document and hold the whole document as a 
DOM tree in memory. 

// parse received xnd validating 

aDocInputSource ■= new inputSource (aProviderResponse) ; 
aDocInputSource.setSysterord(sDecodedURL) ; 
aValParser. parse (aDocInputSource I ; 
aSourceDoc - aValDocBuilder . getDocument ( > ; 



The XSL stylesheet is parsed and loaded into a memory. 

// parse xsl file NOM validating 
aTempURL = aXSLFull. toURL ( ) ; 
^5 aXSLParameters .put { "Transf ormURL" , 

aTempURL. tostringo } f 

aTransInputSource - new 
InputSource (aTempURL. toSt ring () ) ; 

aParser .parse (aTransInputSource) ; 
aTransfonnerDoc « aDocBuilder .getDocument () ; 

20 If the haded document is a list of channels, this document is modified in a memory to 

which a user is not subscribed or of which the MIME type is not accepted for the response. 
This is necessary, because such content could not be displayed on a user device. 



25 



if 

tsResponseConcent .equals (" text/ vnd. sun. xml .Channels") ) 

( 

Element aRootElemcnt 



30 
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aSourceOoc . getDocumentEIement ( ) ; 

TreeWalker aRootWalker 

new TreeWalker (aRootElement) / 
Element aChannelElement - null; 

// walk through channel elements 
while ( (aChannelElement = 

aRoottf a 1 ke r . ge tNex t E 1 emen t ( *'Channe 1 •* ) ) 

!= null) 



( 



// set subscribed attribute 
String sHref ^ 



40 



aChanneiElement .getAttribute ("href ") ; 



sHref ) ) 



if (aE>ataFacade .isSubscribed( 

sSessionId, 



aChannelElement . se tAttribute ( 
"subscribed", "true**); 



45 



else 



aChannelElement . setAtt ribute t 
"subscribed", -false"); 



50 



55 



TreeWalker ( aChannelElement) ; 



channel 



TreeWalker aChannelWalker = 
new 

Element aMime Element - null; 
boolean bMimeAccepted = false; 

// walk through mime-type elements of 

while ( ( (aMimeEleroent » 

aChannelWalker . getNextElement ( 
"mime-type")) null) 
( ibMimeAccepted) I 
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aMimeElement . getFirstChild ( ) ; 
String (aNode.gecNodevalue 0 ) ; 



Node aNode - 
String sMimeType » new 



bHimeAccepted 

aDataFacade . isMimeType Accepted C 
sSessionId, sMimeType); 



10 



15 



// set accepted attribute 
f (bHimeAccepted) 

aChannelElement . setAttribute ( 

"accepted" , "true** ) ; 



else 



aChann el Clement . setAttribute [ 

''accepted'*, "false"); 



20 
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If the loaded document is an article, it is checked, if this MIME type is accepted as a 
response. 

else 

if (sResponseContent. equals ( "text/vnd . sun. xral .Article") ) 

Element aRootElement - 

aSourceDoc.getDocumentElement f ) ; 

Treewalker aRootNalker = new 



Element 



TreeWalker (aHoot Element} ; 
altemElement » null; 



null) 



// walk through item elements 
while ( (altemElement - 

aRootWalker.getNextElement ( "Item") ) 



( 



TreeWalker (altemElement) ; 



) 



aMimeElement . getFirstChild ( ) ; 
St ring ( aNode . ge tNodeValue ( ) ) ; 



SMimeType) ; 



"true") ; 



TreeWalker altemWalker » new 

Element aMimeElement = null; 
boolean bHimeAccepted false; 

// walk through mime-type elements of 

while (({aMimeElement « 

altemWalker.getNextElement ( 

"mime-type") ) f« null) 
( ! bHimeAccepted) 

( 

Node aNode « 
String sMimeType = new 



bMimeAccepted = 

aDataFacade . isMimeType Accepted < 
sSessionId, 



// set accepted attribute 
if (bMimeAccepted) 
{ 

altemElement. setAttribute ( 

"accepted". 
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else 
( 

altemEiement. setAttribute ( 

"accepted**, 

"false"); 

> 

) 

) 

The global parameters for the XSL transformation are set and the loaded XML document 
is transformed according to the rules in the loaded XSL stylesheet, 

aTransformerOoc « aOataFacade .set Parameter s { 
aTransformerDoc, aRequest, 

aXSLParameters) ; 

// transform 

aTrans former .createTrans form (aTransformerDoc) 
. trans form (aSourceDoc, aDrainDoc) ; 

The outpuistream for the response is obtained and the transformed XML document is 
streamed, which now can be, for example, HTML or WML to this stream. The webserver • 
delivers this stream as the response of the original request to the client. 

// write it 

OutputStream aOutStream 

aP.esponse .gctOutputStreamt ) ; 

aResponse.setContentType isPreferre<JMiroeType» ; 
aOrainDoc. write (aoutStream) ; 
aOutStream. f lushO ; 

) 

J 

catch ( . . . 

I 

} 

[0672] While in the above CHAPTER A the basic elements of the networic portal system have been described, a 
more detailed description of elements of the networic portal system are is given in the following CHAPTERS B, C. D, 
E. It is noted that these further examples of the elements may be used with the embodiments of the network portal 
system described above in CHAPTER A. 

[0673] CHAPTER B provides ,e.g., a detailed description of a bridge and proxy, to allow for dynamically dispatching 
function calls from a first execution environment to a second execution environment. 

[0674] CHAPTER C describes to use services or applications on a network portal system allowing e.g., a remote 
control and interaction with run time environment component. 

[0675] CHAPTER D describes for example to select porttets that may be accessed by a user device, e.g. to provide 
a computer- based representation manager and method for individual user-device data representation. 
[0676] CHAPTER E describes that a data filter may be used dynamically, such that a complete data file is not stored 
in an Intermediate format. Rather, for example, the output from a first partial filter adapter is input to a second partial 
filter adapter before all the data has been processed by the first partial filter adapter, providing for a dynamic conversion 
of data. 

CHAPTER B 

[0677] Chapter B describes a method and system for dynamically dispatching function calls from a first execution 
Environment to a second execution environment, e.g. in the network portal system of CHAPTER A. 

BACKGROUND 

Field 

[0678] CHAPTER B relates generally to executing computer software programs generated by different compilers. 
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and in particular to a method for enabling a first computer software program using a first binary spectftcation to employ 
functionality of a second computer software program using a second binary specification, e.g. in the network portal 
system of CHAPTER A. 

5 Description of Related Art 

[0679] Many computer software programs, which are created In different programming languages, have to commu- 
nicate with each other. For example, a first computer software program, sometimes called the first software program, 
created in a first computer programming language is able to provide tables. The first software program calls a second 
10 software program created in a second programming language, which is able to calculate figures that are needed in 
the table to be produced by the first software program. (As those of skill In the art will appreciate, when it is stated that 
a software program performs an action, this means that upon execution of the software program on a processor, the 
system including the processor performs the action in response to execution of an instruction or instructions in the 
software program.) 

15 [0680] Since the two software programs are written In different languages, the two software programs have different 
binary specifications. The second software program cannot be successfully called by the first software program because 
the different binary specifications prevents the second software program from correctly executing the call from the first 
software program. 

[0681] In this example, the different binary specifications result from different computer programming languages. 
20 However, binary specifications for the same computer programming language can be different based upon the differ- 
ences in the compilers for the same programming language. 

[0682] The prior art solution to this problem was to provide transformer modules for each required transformation 
route, for example from a certain first binary specification to a certain second binary specification. Since in modern 
computer applications, a certain software program may call many different software programs, the computer system 

25 requires a voluminous library of transformer modules. This extensive library needs significant storage space and regular 
maintenance, since for every new binary specification, which shall be accessible, a full new set of transfomner modules 
must be provided to each of the other binary specifications, in addition to the existing transformer modules. However, 
most of these transformer modules are not used frequently, so that their storage is not efficient. 
[0683] Furthermore, these prior art transformer modules extend to the full functionality of the software program to 

30 be translated from one binary specification to another. Due to the regularly wide functionality of software programs, 
known transformer modules are rather voluminous and require, when they are activated, a significant amount of working 
memory and processor time from the computer system on which they are executed. Furthermore, the complete trans- 
lation of a software program is burdensome and time consuming, although it is in most cases unnecessary for the 
specific task to be accomplished. 

35 

SUMMARY 

[0684] Therefore, it is desirable to provide an efficient method to enable a first software program to employ certain 
functionalities of a second software program, wherein the first and the second software program use different binary 
40 specifications. 

[0685] According to one embodiment, an efficient method Is provided to enable a first software program to employ 
certain functionalities of a second software program, where the first and the second software program use different 
binary specifications, i.e., the first and second software programs are in different execution environments. 
[0686] In one embodiment, a method for enabling a first software program using a first binary specification in a first 
45 execution environment to employ a limited functionality of a second software program using a second binary specifi- 
cation In a second execution environment first creates a bridge in the first execution environment. Using the bridge, a 
proxy wrapping an interface to the limited functionality of the second software program in the second execution envi- 
ronment Is created In the first execution environment. 

[0687] In another embodiment, a method, dynamically implemented by a process in a first execution environment 
50 generates a binary specification object for the first execution environment. A binary specification object for a second 
execution environment is also generated. Next the process generates a bridge object for mapping objects from the 
second execution environment to the first execution environment. For example, using the bridge object, the process 
generates a proxy wrapping an interface in the second execution environment. The interface in the second execution 
environment is used to access limited functionality in the second execution environment. 
55 [0688] In one embodiment, to use the limited functionality in the second execution environment in a first execution 
environment, a process executing in the first execution environment calls a method In a proxy interface in the. first 
execution environment. In response to the call, the proxy interface converts the method to a corresponding method 
call for execution In the second execution environment. A method type description Is used to convert parameters from 
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the first execution environment to the second execution environment, and in one embodiment, a parameter type de- 
scription for the method is used. 

[0689] The proxy interface dispatches the corresponding method call for execution in the second execution environ- 
ment to the second execution environment by the proxy Interface. In response to the con-esponding method call in the 

5 second execution environment, the method providing the limited functionality is executed and the results of the exe- 
cution are returned to the proxy interface. Using a type description, the returned results from the second execution 
environment are converted to the first execution environment and returned to the calling process. In one embodiment, 
the second execution environment is a C++ programming language execution environment. 
[0690] In another embodiment, a computer program product comprises computer program code for a method for 

10 enabling a first software program using a first binary specification in a first execution environment to employ a limited 
functionality of a second software program using a second binary specification in a second execution environment, 
the method comprising: 

creating a bridge in said first execution environment; and 

15 

creating, in said first execution environment using said bridge, a proxy wrapping an interface to said limited func- 
tionality of said second software program in said second execution environment. 

[0691] In another embodiment, a computer program product comprises computer program code for a method for 
20 using functionality in a second execution environment in a first execution environment, the method comprising: 

calling a method in a proxy interface in said first execution environment; and 

converting said method call by said proxy interface to a con-esponding method call for execution in said second 
25 execution environment. 

[0692] One embodiment includes a computer storage medium having stored therein a stmcture comprising a binary 
specification for an execution environment that in turn includes a simple common identity structure. Optionally the 
binary specification also includes an extended environment structure. In one embodiment, the simple common identity 
30 structure includes: a type name, a context, a pointer to the extended environment stmcture, and methods acquire, 
release and dispose. 

[0693] In a further embodiment, a method is provided for enabling a first software program using a first binary spec- 
ification to employ a limited functionality of a second software program using a second binary specification, including 
the following steps: 

35 

a) initiating the creation of a stub, which is able to transform commands relating to the limited functionality of the 
second program between the second binary specification and an intermediate binary specification, using a second 
bridge, wherein the second bridge provides a mapping of the second binary specification and the intermediate 
binary specification, 

40 

b) initiating the creation of a proxy, which is able to transform commands relating to the limited functionality of the 
second program between the first binary specification and the intermediate binary specification, using a first bridge, 
wherein the first bridge provides a mapping of the first binary specification and the intemnediate binary specification, 
and 

45 

c) initiating the an^angement of the proxy and the stub relatively to the first program and the second program in a 
manner allowing the first program to employ the limited functionality of the second program. 

[0694] Software programs generally are compiled executable programs. Software programs are initially written in a 
50 programming language, for example, C++ or Java or an object model like Corba. They are compiled with compilers 
corresponding to the programming language. However, for each programming language several compilers may be 
available. The binary specification in which a software program is able to communicate with other software programs 
depends on both, the programming language and the compiler. This communication language of a software program 
is the language referred herein as the binary specification used by a software program, for example, the first, the 
55 second and the intemnediate binary specification. 

[0695] The intermediate binary specification serves as the binary specification into and from which the communication 
between the first and the second software program will be translated. This intemnediate binary specification may be, 
for example, an existing binary specification like the binary specification of a specific compiler, but it is also possible 
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that this intermediate binary specification is a suitable newly created binary specification, for example, a binary spec- 
ification which facilitates translation into and from it. 

[0696] The two transformer modules, called pre>xy and stub, may be created on demand, that means if and when 
they are needed. This creation on demand will be initiated directly that means by the first software program or by means 
of an initiating function. This creation on demand is considered to be dynamic, so that the commands of the first software 
program may be dispatched dynamically. The two transformer modules are at least able to transfomi commands cor- 
responding to a limited functionality of the second software program. Since the first software program employs in most 
cases only a part of the functionality of the second software program, the two transformer modules need to transfonn 
only commands which correspond to this limited functionality. Commands may be understood to be any kind of message 
initiating any kind of activity of a software program and which may be transmitted between the two software programs. 
[0697] It is possible to insert further modules between these two transfomier modules. These modules may be able 
to intercept the commands. This interception may be used, for example, to add security or accounting functionality. It 
is also possible to use these two transformer modules to synchronize the commands or to use them for debugging. 
[0698] For the creation of the proxy and the stub mappings between the basic commands, on which all other com- 
mands are based, of the two pairs of participating binary specifications are used. These pairs are the first binary spec- 
ification and the intermediate binary specification and the second binary specification and the intermediate binary 
specification. These mappings will be provided by the bridges and maybe, for example, stored in a data base. However, 
the bridges may also already be a part of the second software program. In case these mappings cover the complete 
functionality of the relevant binary specifications - which is frequently the case - only some parts of the mapping may 
be considered during the creation of the proxy and the stub, since they relate to the above mentioned limited functionality 
only 

[0699] After their creation the proxy and the stub are arranged in a manner which enables the first software program 
to communicate with the second software program. That means a path of communication must be arranged from the 
first software program to the proxy, from the proxy to the stub, and finally from the stub to the second software program. 
This route must regulariy be accessible from both sides, that means from the side of the first software program as well 
as from the side of the second software program. 

[0700] In order to generate the stub the second binary specification used by the second software program must be 
known. For this purpose, the first software program may start the second software program. This may be done by the 
first program by means of a loader function which loads the second software program. Loader functions are well known 
in the prior art. A loader function is able to initiate a software program using a certain binary specification on demand 
of another software program using a different binary specification. The loader function may directly initiate the creation 
of the required stub or it may initiate that the second software program or an auxiliary program communicating with 
the second software program creates the stub. This is possible, if the loader function canies or supplies by any means 
the information about the limited functionality of the second software program requested by the first software program. 
[0701] The creation of the stub may be carried out by the second software program or by any sub-program of the 
second software program. It is possible that this sub-program exists already in the second software program. However, 
this sub-program may as well be procured or generated by the second software program in response to a request of 
the first software. 

[0702] After the creation of the stub, the initiated second software program or its sub-program creating the stub may 
inform the first software program that the stub has been created. This may initiate the creation of the proxy by the first 
software program or any suitable sub-program, as it was described above for the creation of the stub. 
[0703] The proxy is created by the first software program or a sub-program, a function thereof. The sub-program of 
the first software program must consider the bridge for the transfomnation of the first binary specification into the inter- 
mediate binary specification and reverse and the requested limited functionality of the second software program. The 
information about the requested limited functionality is generally available in the first software program, because the 
first software program requests this limited functionality from the second software program. 

[0704] In order to enable the communication between the first software program and the second software program 
the stub and the proxy may transform any commands or other messages between these two software programs, as 
far as the proxy and the stub support this functionality. This requires the above described an-angement of the proxy 
and the stub relatively to the first and the second software program. 

[0705] A method for employing a limited functionality of a second software program using a second binary specifi- 
cation by a first software program using a first binary specification, includes the following steps: 

a) initializing the limited functionality of the second software program by the first software pnjgram, 

b) creating a stub, which is able to transform commands relating to the limited functionality of the second software 
program between the second binary specification and an intermediate binary specification, using a second bridge, 
wherein the second bridge provides a mapping of the second binary specification and the intermediate binary 
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specification. 

c) creating a proxy, which is able to transfomi commands relating to the limited functionality of the second software 
program between the first binary specification and the Intermediate binary specification, using a first bridge, wherein 

5 the first bridge provides a mapping of the first binary specification and the intermediate binary specification, 

d) transmitting an command relating to the limited functionality from the first software program to the proxy. 

e) transforming the command from the first binary specification into the intermediate binary specification by the 
10 proxy, 

0 transmitting the command transformed by the proxy from the proxy to the stub, 

g) transforming the transmitted command from the intermediate binary specification into the second binary spec- 
ks ificatlon by the stub, 

h) transmitting the command transfonned by the stub from the stub to the second software program, 

i) carrying out the command In the second software program and generating a response for the first software 
20 program, 

j) transmitting the response, being in the second binary specification, from the second software program to the stub, 

k) transforming the response from the second binary specification into the intermediate binary specification by the 
25 stub. 

I) transmitting the response transformed by the stub from the stub to the proxy. 

m) transforming the response from the intemiediate binary specification into the first binary specification by the 
30 proxy, 

n) transmitting the response transformed by the proxy from the proxy to the first software program. 

[0706] The transmissions between the proxy and the stub and the software programs and the proxy or the stub, 
respectively, may be effected by any suitable means. It Is relevant, however, that these elements are an'anged so as 
to allow the communication of the two software programs. 

[07071 Furthermore, a method for using a stub, which is able to transform commands relating to a limited functionality 
of a second software program between a second binary specification and an Intemiediate binary specification, using 
a second bridge, wherein the second bridge provides a mapping of the second binary specification and the intermediate 
binary specification, is provided for enabling a first software program using a first binary specification to employ the 
limited functionality of the second software program by further using a proxy, which Is able to transform commands 
relating to the limited functionality of the second software program between the first binary specification and the inter- 
mediate binary specification, using a first bridge, wherein the first bridge provides a mapping of the first binary speci- 
fication and the intermediate binary specification, wherein the proxy and the stub are an*anged relatively to the first 
software program and the second software program In a manner allowing the first software program to employ the 
limited functionality of the second software program. 

[0708] Also provided is a method for using a proxy, which is able to transform commands relating to the limited 
functionality of the second software program between the first binary specification and the intermediate binary speci- 
fication, using a first bridge, wherein the first bridge provides a mapping of the first binary specification and the Inter- 
mediate binary specification, for enabling a first software program using a first binary specification to employ the limited 
functionality of the second software program by further using a stub, which is able to transform commands relating to 
a limited functionality of a second software program between a second binary specification and an intemiediate binary 
specification, using a second bridge, wherein the second bridge provides a mapping of the second binary specification 
and the intermediate binary specification, wherein the proxy and the stub are an-anged relatively to the first software 
program and the second software program in a manner allowing the first software program to employ the limited func- 
tionality of the second software program. 

[0709] There is also provided a computer program, also refen*ed to as a computer program product, for carrying out 
operations of the above methods. A computer program product comprises a medium configured to store or transport 
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computer readable code, or in which computer readable code may be embedded. Some examples of computer program 
product are: CD-ROM disks, ROM-cards, floppy disks, magnetic tapes, computer hard drives, servers on a network 
and carrier waves and digital signals transmitted over a telecommunication link or networic connection. 
[071 01 Such computer program may be stored on any data carrier, such as, for example, a disk, a CD or a hard disk 
of a computer system. It is further provided a method for using a computer system, including standard computer sys- 
tems, for carrying out the present inventive method. Finally, a computer system comprises a storage medium on which 
a computer program for carrying out operations of the above methods. 

BRIEF DESCRIPTION OF THE DRAWINGS OF CHAPTER B 
[0711] 

Fig. 1 A is a high level representation of a ftrst embodiment of the present invention; 

Pig 1 B is a high level representation of a second embodiment of the present invention; 

Fig. 1C is a more detailed representation of the first embodiment of the present invention; 

Figs. 2A and 28 are one embodiment of a binary representation of an environment according to one embodi- 
ment of the present invention; 

Figs. 3A and 38 are one embodiment of the binary specification structure of Fig. 2B; 

Fig. 4 is a sequence diagram illustrating one embodiment of making a proxy interface of the present 

invention, and one embodiment of using the proxy interface of the present invention; 

Fig. 5 is an example of a binary specification of the type representation in the UNO typelibrary ac- 

cording to one embodiment of the present invention; 

Fig. 6 is an illustration of stack configuration used in one embodiment of a C++ environment; 

Fig. 7A is an illustration of a virtual table in one embodiment of the present invention; 

Fig. 7B is an illustration of assembler code used to generate an index to a slot in the virtual table of 

Fig. 6; 

Fig. 8 is a process flow diagram for one embodiment of a method perfomned by a C++ proxy wrapping 

a UNO interface; 

Fig. 9 is a process flow diagram for one embodiment of a method mediate that is used by the method 

of Fig. 8; 

Fig. 10 is a process flow diagram for one embodiment of a method Env1_to_Env2 with interface that 

is used by method mediate of Fig. 9; 

Fig. 11 is a prc^cess flow diagram for one embodiment of a method performed by a UNO proxy wrapping 

a C++ interface; 

Fig. 12 is a process flow diagram for one embodiment of a method Env2_to_Env1 with interface that 

used by the method of Fig. 11 ; 

Figs. 1 3A and 1 3B are an example of mapping an interface from a UNO environment to a C++ UNO environment 
according to one embodiment of the present invention; 

Fig. 14 is an example of fi-eeing a C++ UNO interface proxy and revoking the proxy of the appropriate 

environment according to one embodiment of the present invention; 

Fig. 15 is an example of a C++ implementation of a C++ UNO proxy according to one embodiment of 
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the present invention; 

Figs. 16A and 16B are an example of a C implementation of freeing a UNO interface proxy and functions acquire/ 
release according to one embodiment of the present invention; 

5 

Figs. 17Aand 17B are an example of mapping an interface from a C++ UNO environment to a UNO environment 
according to one embodiment of the present invention; 

Pig 18 is an example of a C++ implementation of a UNO proxy according to one embodiment of the 

10 present invention; 

Pjg 19 is an example of various constmctors of a mapping and a bridge and of a free function of a 

bridge according to one embodiment of the present invention; 

15 Fig. 20 is an example of an implementation of functions acquire and release for a bridge according to 

one embodiment of the present invention; 

Pig. 21 is an example of an implementation to create a mapping between to environments according 

to one embodiment of the present invention; 

20 

Figs. 22A and 22B are an example of an implementation to create the static part of an object identifier according 
to one embodiment of the present invention; 

Pig. 23 is an example of an implementation to create an object identifier according to one embodiment 

25 of the present invention; 

Pig. 24 is an example of an implementation of methods acquire/release in a C++ UNO environment 

according to one emt>odiment of the present invention; 

30 Fig. 25 schematic representation of the inventive method in overview; 

Pig, 26 shows a flow chart: initial communication of a first and a second software program; 

Pig, 27 shows a flow chart: creation of a stub; 

35 

Pig. 28 shows a flow chart: creation of a proxy; 

Pig. 29 shows a flow chart: an-anging a stub and a proxy; 

40 Fig. 30 shows a schematic representation of a computer system to be used in the scope of the present 

invention; 

Fig. 31 shows a representation of a client-server system to be used in the scope of the present inven- 

tion; 

45 

Fig. 32 shows a flow chart: calling of a stub; 

Fig. 33 flow chart: calling of the second program through the stub; 

50 Fig. 34 flow chart: binding a stub and a proxy; 

Pig. 35 shows a flow chart: calling the second software program from a first software program via a 

proxy and a stub; 

55 Fig. 36 shows a flow chart: transforming and transmitting a command from the first software program 

to the second software program; 

Pig. 37 schematic representation of an interceptor arranged between a stub and a proxy; and 
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Fig. 38 shows a flow chart use of an interceptor function in an an-angement of stub and proxy. 

[0712] In the Figures 1 - 38 of CHAPTER B and the following Detailed Description of CHAPTER B. elements with 
the same reference numeral are the same element or a similar element. Also, the first one or two digits of a reference 
5 numeral for an element indicate the figure in which that element first appeared. Reference numerals do not necessarily 
correspond to the reference numerals used in the further chapters. 

DETAILED DESCRIPTION 

10 [071 3] According to one embodiment, a computing system 1 00 includes a service 111, which is part of a first computer 
software program 110 executing within a first execution environment 120. Service 111 issues a call 112 to a service 
161 of a second computer software program 160 executing within a second execution environment 150 that is different 
from first execution environment 120. For example, sers^ce 111, in one emtkxJiment, is a part of a word processing 
program that issues a call to a calculator, which is service 161 . of a spreadsheet program, where the word processing 

15 program Is written in a Visual Basic computer programming language, and the calculator is written in the C programming 
language. 

[0714] Unlike the prior art In which calls to a different execution environment with a different binary specification 
could not be handled in most cases, and in a limited number of cases could be handled by marshalling the call into a 
specific predefined byte stream (for example the CORBA byte stream) for passing to the different execution environ- 

20 ment, call 112 from first execution environment 120 with a first binary specification is directed to a proxy 130 In a bridge 
140. Proxy 1 30 converts any parameters in the call to parameters for second execution environment 1 50 using a type 
description that is described more completely below, and then dispatches a call 170. with the converted parameters, 
toservice161 in second execution environment 150. Call 170 corresponds to call 112 in first executionenvironment 120. 
[0715] In response to call 170 from proxy 130. service 161 performs the action requested and retums the result to 

25 proxy 1 30. Proxy 1 30 converts the result and any parameters returned from second execution environment 1 50 to first 
execution environment 120. 

The converted results are in turn provided to service 111 . 

[071 6] Hence, according to one embodiment of the present invention, a first service, sometimes called a component 
or an object, with a first binary specification in a first execution environment utilizes a second service sometimes called 

30 a comjDonent or an object, in a second execution environment with a second binary specification that is different from 
the first binary specification. This greatly extends and facilitates providing an application with a broad range of capa- 
bilities without having to port the application and/or all of the capabilities to the binary specification of each execution 
environment in which the application may run. In addition, this embodiment facilitates providing a particular functionality 
to an application that is executed in an execution environment that does not, and perhaps cannot, support that particular 

35 functionality. 

[0717] In the embodiment of Figure 1A, proxy 130 is instantiated by bridge 140 that is in first execution environment 
120 and proxy 130 communicates directly with service 161 that is in second execution environment 150. However, in 
another embodiment, proxy 130A in response. to a call 112 from service 111 of software program 110 issues a call 131 
to an intemnediary proxy 185 in execution environment 180 that is different from t)Oth execution environment 120 and 

40 execution environment 150, in this example. 

[0718] Intermediary proxy 130A converts the call from the first binary specification to the binary specification for 
execution environment 180 and dispatches a call 131 to intemnediary proxy 185. Intermediary proxy 185 converts the 
call from the binary, specification of execution environment 180 to the binary specification of execution environment 
150 and then dispatches call 186 to service 161. The response from service 161 is returned to intemriediary proxy 185 

45 that converts the response to binary specification of execution environment 180, and In turn transmits the converted 
response to proxy 130A. Proxy 130A converts the response from the binary specification for execution environment 
180 to the binary specification for execution environment 120 and retums the result to service 11 1 of software program 
110. 

[0719] To reduce the number of bridges, normally only bridges to Intermediate environment 180. referred to herein 
50 as the binary UNO specification environment, exist. To make a bridge from a C programming language (C) execution 
environment to a C++ programming language (C++) execution environment, call traffic is delegated over two bridges 
140A and 190. First bridge 140A is from the C execution environment to the binary UNO execution environment and 
theri bridge 190 is from the binary UNO execution environment to the C++ execution environment. In this way, only (n 
-1) bridges are needed for n different environments instead of n*(n - 1)/2 bridges, if a direct connection between envi- 
55 ronments is made as in Fig. 1 A. Preferably each bridge can create proxy objects only from the description of an interface. 
This implies that the code may be generated at runtime. 

[0720] Returning to Figure 1A, as explained more completely below, a source environment object 103 and a desti- 
nation environment object 104 are initially created using a runtime library, and optionally registered in an execution 
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environment, e.g.. execution environment 120. Each of objects 103 and 104 includes a binary specification structure 
for its respective execution environment. As explained more completely below, a binary specification structure, in one 
embodiment, provides common functions for each environment, and knows all proxies, sometimes called proxy inter- 
faces, and their origins. Thus, an execution environment, through its binary specification structure, knows each wrapped 

5 interface, i.e.. proxy, running in execution environment and the origin of each of these wrapped interfaces. 

[0721] After the objects 103 and 104 are created, a call is made by service 111 that results in a search for a shared 
library that is activated as a bridge for the two execution environments. Each bridge, e.g.. bridge 140, is implemented 
in a separate shared library. In one embodiment, the name of the shared library is a connection of two environment 
names with an underscore ('_') between the names. 

10 [0722] Next a call is made by service 1 11 to map an interface of the source environment. Mapping is the direct way 
to publish an interface in another environment That means an interface is mapped from a source environment 150 to 
a destination environment 120 so that methods may be invoked on a mapped interface, i.e., proxy 130, in destination 
environment 120, which, in turn, are delegated to the originating interface in the source environment 
[0723] Mapping an interface from an environment 150 to an environment 120 requires several operations that are 

15 described more completely below with respect to Figure 4. However, briefly, a call is made to bridge 140 to map a 
particular interface for service 161 in source execution environment 150 to destination execution environment 120. If 
a proxy already exists for this mapping, a handle to the proxy is returned to service 111. Alternatively, as explained 
below, bridge 140 creates proxy 130. and returns a handle to service 111 so that subsequent calls to the interface for 
service 161 are directed to proxy 130. 

20 [0724] Hence, as used herein, a bridge 140 in a first environment 120 is defined to be a software module that upon 
execution initially creates a proxy object 130 in first environment 120 for one computer programming language and 
hardware platform so that an actual object 161 . sometimes called real object 161 , represented by proxy 130, is available 
from a second environment 150. Proxy object 130 looks like and is an object implemented in first environment 120, 
and so proxy object 130 can be transparently used. Proxy object 130 delegates calls to real object 161 in second 

25 environment 150. 

[0725] In one embodiment, real object 161 in second environment 150 is implemented in the C programming lan- 
guage (C) and real object 161 is accessed from a C++ programming language (C++] environment. In this case, bridge 
140 is from a C++ environment to a C environment. Remember that C++ is incompatible between different compilers 
and different switches. Bridge 140 creates a C++ proxy object 130 in first environment 120, which delegates calls to 
30 real object 161 implemented in C. Sometimes a bridge is called language binding, but this description is not exact, 
because bridges also connect object models in ano^er embodiment of the present invention. 
[0726] The particular configuration of computing system 1 00 is not essential to this invention. Execution environments 
120 and 150, in one embodiment, are included within the same computer. 

[0727] In another embodiment, execution environment 120 is in a client system and execution environment 150 is 

35 in a server system. In this embodiment, the client system can be a mobile telephone, a two-way pager, a portable 
computer, a workstation, or perhaps a personal computer. The client and server can be interconnected by a local area 
network, a wide area network, or the Internet As explained more completely below, the dynamic dispatch functionality 
of this invention is independent of the network protocol and the network architecture. In yet another embodiment, 
execution environment 120 is in a first computer and execution environment 150 is in a second computer where the 

40 first and second computers are in a peer-to-peer network. 

[0728] Figure ICisan example of a user device 102 that is executing service 111 of application 110 from a volatile 
memory 1 22 on CPU 1 0 1 . Application 1 1 0 can be any application, or an application in a suite of applications that can 
include for example a word processing application, a spreadsheet application, a database application, a graphics and 
drawing application, an e-mail application, a contacts manager application, a schedule application, and a presentation 

45 application. One office application package suitable for use with this embodiment of the invention, is the STAROFFICE 
Application Suite available from Sun Microsystems. 901 San Antonio Road, Palo Alto. CA. (STAROFFICE is a trade- 
mark of Sun Microsystems. Inc.) The user has access to the functionality of service 161 even thought the execution 
environment for computer 155 is different from the execution environment of user device 102 and even in situations 
where in addition user device 102 has neither the memory capacity nor the processing power to execute service 161 . 

50 [0729] In the emtKKliment of Figure 1C, a runtime library 108 is initially stored in a non-volatile memory 121 and a 
part or all of runtime library 1 08 is moved to volatile memory 1 22 to generate source environment object 1 03, destination 
environment object 104 and bridge 140. In one embodiment, bridge 140 includes a shared library and is the same 
. library as runtime library 108. 
[0730] In this embodiment, when proxy 130 receives a method call from service 111, proxy 130 dispatches the call 

55 to service 161 via I/O interface 122 that is connected to network interface 1 83 of computer 1 55 via networics 1 05 and 1 06. 
[0731] Those skilled in the art will readily understand that the operations and actions described herein represent 
actions perfomied by a CPU of a computer in accordance with computer instructions provided by a computer program. 
Therefore, bridge 140. proxy 130, source environment object 103, and destination environment object 104 may be 



139 



EP 1 126 681 A2 



imptemented by a computer program causing the CPU of the computer to carry out instructions representing the indi- 
vidual operations or actions as described herein. The computer Instructions can also be stored on a computer-readable 
medium, or they can be embodied in any computer-readable medium such as any communications link, like a trans- 
mission link to a LAN, a link to the internet, or the like. 

5 [0732] Thus, all or part of the present invention can be implemented by a computer program comprising computer 
program code or application code. This application code or computer program code may be emt>odied in any form of 
a computer program product. A computer program product comprises a medium configured to store or transport this 
computer-readable code, or in which this computer-readable code may be embedded. Some examples of computer 
program products are CD-ROM discs, ROM cards, floppy discs, magnetic tapes, computer hard drives, servers on a 

10 networtc. and carrier waves. The computer program product may also comprise signals, which do not use earner waves, 
such as digital signals transmitted over a networic (including the Internet) without the use of a earner wave. 
[0733] The storage rnedium including runtime library 108 may belong to user device 1 02 itself. However, the storage 
medium also may be removed from user device 102. The only requirement is that the runtime library is accessible by 
user device 1 02 so that the computer code corresponding to the environment objects, bridge and proxy can be executed 

15 by user device 102. Moreover, runtime library 108 can be downloaded from another computer coupled to user device 
102 via a network. Also, user device 102, as explained above, can also be a server computer and so the configuration 
of Figure 1C is illustrative only and is not intended to limit the invention to the specific embodiment shown. 
[0734] Herein, a computer memory refers to a volatile memory, a non-volatile memory, or a combination of the two 
in any one of these devices. Similariy, a computer input unit and a display unit refer to the features providing the required 

20 functionality to input the Infomiation described herein, and to display the infomiation described herein, respectively, in 
any one of the aforementioned or equivalent devices. 

[0735] As used herein, software programs are compiled executable programs. Software programs are initially written 
in a programming language, for example, C, C++ or JAVA or an object model like CORBA or UNO. They are compiled 
with compilers con-esponding to the programming language. However, for each programming language several com- 

25 pilars may be available. The binary spedfication in which a software program is able to communicate with other software 
programs depends on both, the programming language and the compiler. This communication language of a software 
..program is the language referred herein as the binary specification used by a software program. 
[0736] As used herein, an execution environment, such as execution environments 1 20 and 1 50. contains all objects, 
which have the same binary specification and which tie in the same process address space. The execution environment, 

30 sometimes called environment, herein, is specific for a computer programming language and for a compiler for that 
computer programming language. For example, an object resides in the "msci" execution environment, if the object is 
implemented with a software program written in the C++ computer programming language, and the software program 
Is compiled with the MICROSOFT Visual C++ compiler. (MICROSOFT Is a trademark of Microsoft Corp. of Redmond, 
WA) An example of a binary specification for one sample execution environment Is presented below in conjunction 

35 with the description of Table 1 , 

[0737] to jassist In the understanding of this invention, examples of a binary specification for an environment, and 
types, type libraries, and a type repository are first considered, and then embodiments to make and use the present 
invention are described. 

40 Binary Specification for an Execution Environment 

[0738] The function of a binary specification for an execution environment is to identify the execution environment, 
and optionally to provide functionality like interface registration. In one embodiment, the structure of a binary specifi- 
cation for an execution' environment is split into a simple common identity structure 220 (See Fig. 2A) that is easily 
45 implemented for bridges that handle object Identity issues. An optional structure 225 may be Included to support optional 
functionality. In one embodiment, the optional functionality includes interface registration, acquiring/releasing in Inter- 
faces of the environment, and obtaining an object Identifier for an Interface. 

[0739] Table 1 is an example of a simple common identity structure 220 (Fig. 2) of a binary speclficaiton for an 
execution environment called uno_enviroment. 

50 



55 
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TABLE 94.: One Embodiment of a Simple Common Identity 
Structure for a Binary Specification of an Execution 

Environment 



10 


typedef struct _uno_Environment 
{ 

void * pReserved; 








15 


rtl_uString * pTypeName; 




void * pContext; 
uno_ExtEnvironment * pExtEnv; 






void {SAL_CALL * acquire) ( uno_Environment 


* pEnv ) ; 


20 


void (SAL_CALL * release) { uno_Enviromnent 


* pEnv ) ; 




void (SAL_CALL * dispose) ( uno_Environment 


* pEnv ) ; 




void (SAL_CALL * environmentDisposing) ( 




25 


uno_Environment * pEnv ) ; 
} uno_Environment ; 





30 

[0740] Pointer pReserved in the UNO environment is reserved and so in this embodiment is set to zero. String 
pTypeName is a type name of the environment. Pointer pContext Is a free context pointer that is used for specific 
classes of environments, e.g., a JAVA virtual machine pointer. (JAVA is a trademark of Sun Microsystems, Inc. of Palo 
Alto, OA.) Pointer pExtEnv is a pointer to and extended environment (interface registration functionality), if supported, 

35 and othenvise is set to zero. 

[0741 1 Method acquire acquires this environment, i.e.. the environment defined by this structure. Parameter pEnv is 
this environment. Method release releases this environment and again parameter pEnv is this environment. Method 
dispose is explicitly called to dispose of this environment, e.g., to release all interfaces. Typically, this method is called 
before shutting down to prevent a runtime error 

40 [0742] In this embodiment, method disposing is a disposing callback function pointer that can be set to be signaled 
before this environment is destroyed. This method is late initialized by a matching bridge and is not for public use 
[0743] Hence, in the embodiment, each simple common identity binary specification structure for an environment 
includes a type name of the environment; a free context pointer, a pointer to an extended environment that includes 
optional functionality, and methods to acquire, release and dispose of the environment. Structure 220 is stored in a 

45 memory 21 0 of computer system 1 00. 



50 
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TABLE 95.: One Embodiment of an Extended Environment 
Structure for a Binary Specification of an Execution 

Environment 



typedef struct _uno_Ext Environment 
{ 

uno_Environment aBase; 

void (SAL_CALL * registerlnterf ace) ( 

uno_ExtEnvironment * pEnv, 

void ** pplnterface, 

rtl_uString * pOId, 

typelib_InterfaceTypeDescription * pTypeDescr ) ; 
void {SAL_CALL * register Proxylnter face) { 
uno_Ext Environment * pEnv, 
void ** ppProxy, 
uno_f reeProxyFunc freeProxy, 
rtl_uString * pOId, 

typelib_InterfaceTypeDescription * pTypeDescr ) ; 
void (SAL_CALL * revokelnterf ace) ( 

uno_ExtEnvironment * pEnv, void * pinterface ) ; 
void (SAL_CALL * getObjectldentif ier) { 

uno_ExtEnvironment * pEnv, 

rtl_uString ** ppOId, 

void * pinterface ) ; 
void (SAL_CALL * getRegisteredlnterf ace) ( 

uno_ExtEnvironment * pEnv, 

void ** pplnterface, 

rtl_uString * pOId, 

typelib__InterfaceTypeDescription * pTypeDescr ); 
void {SAL_CALL * getRegisteredlnterf aces) ( 
uno__ExtEnvironment * pEnv, 
void *** ppplnterf aces, 
sal_Int32 * pnLen, 
uno_memAlloc memAlloc ) ; 
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void (SAL_CALL * computeObjectldentif ier ) ( 
uno_ExtEnvironment * pEnv^ 
rtl_uString ** ppOId, void * pinterface ); 
void (SAL_CALL * acquirelnterf ace) { 

uno_ExtEnvironment * pEnv, void * pinterface ) ; 
void (SAL_CALL * releaselnterf ace) { 

uno_ExtEnvironment * pEnv, void * pinterface ) ; 
\ uno Ext Environment; 



[0744] Table 2 is one embodiment of a binary specification of an UNO environment supporting interface registration. 
This binary specification Inherits all members of a uno_ Environment as defined, for example, by Table 1 above. 
[0745] Method register! nterface in Table 2 registers an interface of this environment. Parameter pEnv is this envi- 
ronment. Parameter pplnterface Is an Inout parameter of the interface to be registered. Parameter pOld is an object 
id of the Interface to be registered, and parameter is a type description of interface to be registered. 
[0746] Method registerProxylnterface in Table 2 registers a proxy interface of this environment. The proxy Interface 
can be reanimated and is freed explicitly by this environment. In this call, parameter pEnv is this environment. Parameter 
pplnterface is an Inout parameter of Interface to tje registered. Parameter freeProxy represents a function to free this, 
proxy object (See Table 3). Parameter pOId Is an object id of the Interface to be registered, and parameter Is a type 
description of Interface to be registered. 

[0747] Method revokel nterface revokes an interface from this environment. Any interface that has been registered 
must be revoked via this method. In the call to this method, parameter pEnv is tiiis environment, and parameter pin- 
terface is the interface to be revoked. 

[0748] Method getObjectldentifier provides the object Id of a given interface. In this method, parameter ppOld is the 

input and output object Identifier (old), and parameter pinterface is the interface of the object. 

[0749] Method getRegistered Interface retrieves an interface identified by Its object Id and type from this environment. 

Interfaces are reti'ieved in the same order as they are registered. In this method, parameter pEnv is this environment. 

Parameter pplnterface Is the inout parameter for the registered interface and is zero if none was found. Parameter 

pOld Is the object Id of the interface to be retrieved, and parameter pTypeDescr Is a type description of interface to be 

retiieved. 

[0750] Method getRegistered Interfaces return all currently registered Interfaces of ttiis environment. The memory 
block allocated might be sllghtiy larger than ('pnLen * si2eof{void *)). In this method, parameter pEnv Is this environment. 
Parameter pplnterfaces is an output parameter that is a pointer to an an-ay of interface pointers. Parameter pnLen is 
an output parameter to a length of the array of interface pointers, and parameter mem Alloc represents a function for 
allocating memory that Is passed back (See Table 4). 

[0751] . Methods computeObjectldentrfier, acquirel nterface and releaselnterface are late Initialized by a matching 
bridge and are hot for public use. Method computeObjectldentlfier computes an object id of the given interface, and Is 
called by the environment implementation. Parameter pEnv is this environment, Parameter ppOld is an output param- 
eter that is the computed id. Parameter pinterface is the given interface. Methods acqulrielnterface and releaselnterface 
are methods to acquire an interface, and release an interface respectively. The Input parameters are defined the same 
as in metiiod computeObjectldentlfier 

[0752] Table 3 is one embodiment of a generic function pointer declaration to free a proxy object, if an environment 
does not need the proxy object anymore. To use this function, the proxy object must register itself on ttie first call to 
method acquireO (See Table 1) call and revoke Itself on the last call to method releaseQ (See Table 1), This can happen 
several times because the environment caches proxy objects until the environment explicitiy frees the proxy object by 
calling this function. In the call to this method, parameter pEnv the environment, and parameter pProxy is the proxy 
pointer. 
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TABLE 96.: One Embodiment of a Definition for 
Function FreeProxyFunc 



typedef void (SAL_CALL * uno_f reeProxyFunc) ( 

uno_ExtEnvironment * pEnv^ void * pProxy ) ; 



[0753] Method memAlloc (Table 4) is a generic function pointer dedaration to allocate memory. This method is used 
with method getRegisteredlnterfaces() (Table 2). Parameter n Bytes is the amount of memory in bytes. This method 
returns a pointer to the allocated memory. 



TABLE 97.: One Embodiment of a Definition for 
Function memAlloc 



typedef void * (SAL_CALL * uno^metnAlloc) ( sal_ulnt32 
nBytes ) ; 



[0754] An altematlve embodiment of a structure 230 for a binary specification of an execution environment Is pre- 
sented in Figure 2B. In this embodiment, all the information including methods needed to manage registering and 
unregistering interfaces are includes in a single structure. Figures 3A and 38 are the information in one embodiment 
of structure 230. Alternatively the information in Tables 2 and 3 could be combined into a single structure. 
[0755] To use environments, the environments are registered. An existing environment Is obtaining by calling a meth- 
od for getting the environment. For the example of Table 1 , method uno_getEnvironment() is used. A new environment 
is created by either implementing the new environment directly, or by using a simple default implementation, which is 
frequently also sufficient, by calling, in the given example, method uno createDefaultEnvironment() with the environ- 
ment's name and the environment's acquire and release functions for Interfaces. 

[0756] Within execution environments, type descriptions are used to map types between environments, A type de- 
scription may exist or may be created at aintime. Each existing type in an execution environment Is stored in a type 
repository along with the con-esponding type description. The type descriptions are accessible through the full name 
of each type in the type repository, in one embodiment. For example, the full name of interface type '"Xlnterface" may 
be '•com.sun.stanXInterface". The naming conventions used to access a type and/or a type description within the type 
repository are not an essential feature of this invention, and any suitable naming convention can be utilized. In a type 
repository, the types and associated type descriptions are stored in any appropriate way 

[0757] If the API (application program interface) of the type repository is a C programming language style, the type 

repository API is directly, that means via a binary representation, accessible from many binary specifications, and the 

type repository API is quickly transferable. Since the type description of each element may be used during the generic 

marshaling of a call, in one embodiment, C-style structures, which describe each type, are used. 

[0758] Figure 5 is an example of a biriary specification 500 of the type representation in the UNO typelibrary. The 

type library includes complete type descriptions for each existing IDL type. These type descriptions are organized in 

a hierarchical form, which represents the IDL module structure including a node for the type itself. Each type node has 

a binary type blob, which contains the complete type information. The structure of the type blob depends on the kind 

of the type. The first part is relevant for each type and the other parts depend on the type. For example, a structure 

has only an additional field section because it isn't possible to spedfy methods for structures. 

[0759] In this embodiment, the structure includes a header section; a constant pool section; a field section; and a 



144 



EP 1 126 681 A2 

reference section. A definition of the information is each section, as illustrated in Figure 5 is given herein. 
[0760] Header section 

magic, type: sal_utnt32 

a reserved field for internal use. 
5 size, type: sal_ulnt32 

represents the size of the blob in bytes. 
minor,major version, type: sal_ulnt16 

two fields to specify a version number for the binary format. 
nHeaderFields, type: sal_uint16 
10 specifies the number of fields in the header section. This number is used for calculating the offset of the 

next section, 

typeSource, type: sai_ulnt16 

specifies in which language the type was defined, e.g. UNO IDL, CORBA IDL or Java. 
typeClass, type: sai_utnt16 
15 specify the typeclass of the described type, e.g. Interface or enum. 

name, type: saLulnt16 

represents an index for a string item in the constant item pool which specifies the full qualified name of the 

type. 

Uik, type: saLulnt16 

20 represents an index for a Uik item in the constant item pool which contains the Uik information for an 

interface. This field Is 0 if the type is not an Interface. 
docu, type: sal_ uint 1 6 

represents an index for a string item in the constant item pool which contains the documentation of this type. 
filename, type sal_ulnt16 

25 represents an index for a string item in the constant item pool which specifies the name of the source file 

where the type Is defined. 

nSuperTypes, type: sal_ulnt16 

specifies the count of supertypes. This field is only relevant for structs, exceptions, services and interfaces. 
If nSuperTypes > 0 than the next section is an area with size nSuperTypes * saLulnt16, which represents indices for 
30 string items in the constant pool. 

Constant pool section 

[07611 The constant pool section consists of nConstantPool Count entries of variable length and type. Each entry 
35 constists of three fields: 

size, type: sal_ulnt32 

specifies the size of the entry in bytes 
type tag, type: sal_ulnt16 

specifies the type of the data field. 
40 data, type: sal_ulnt8 

specifies the raw data of the entry with (size - si2eof(sal_ulnt32) - sizeof(sal_ulnt16)) bytes. 

Field section 

45 [0762] The field section represents type infomnation for struct or exception members, const types, enums. service 
members and attributes of Interfaces. This section only exists if the field nFieldCount is greater than zero. 
nFieldCount, type: sal_ufnt16 

specifies the number of fields in the field section. 
nFieldEnthes. type: sal_ulnt16 

50 specifies the number of fields for each entry in the field section. This number is used for calculating the 

offsets in the field section. 
access, type: sal_ulnt16 

specifies the access of the field, e.g. readonly 
name, type: sal_ulnt16 

55 represents an index for a string item in the constant item pool, which specifies the name of the field, 

typename, type: sal_ulnt16 

represents an index for a string item in the constant item pool, which specifies the full-qualified typename 

of the field. 
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value, type: saLulnt16 

~- represents an index for an item in the constant item pool with the same type specified by typename which 
represents the value of the field, e.g., the initial enum value or the value of a constant. This field could be 0. 
docu, type: sal_ulnt16 

represents an index for a string item in the constant item pool, which contains the documentation of this field. 
filename, type: saLulntIS 

represents an index for a string item in the constant item pool, which specifies the name of the source file 
where the field is defined. This could be different from thefilename in the header section, because constants could be 
defined in different source files. 



Method section 

[0763] The method section represents type infomfiation for interface methods. This section only exists if the field 
nMethodCount is greater than zero. 
nMethodCount, type: sal_ulnt16 
specifies the number of methods in the method section. 
nMethodEntries, type: sal_utnt16 

specifies the number of fields for each entry in the method section. This number is used for calculating the 
offsets in the method section. 

nParameterEntries, type: sal_ulnt16 

specifies the number of fields for each entry in a parameter section. This number is used for calculating 
the offsets in the parameter section. 
size, type: saLulnt16 

specifies the size of the current method entry in bytes. 
mode, type: sal_uint16 

specifies the mode of the method, e.g., oneway 
name, type: sal_ulnt16 

represents an index for a string item in the constant item pool, which specifies the name of the method. 
returntype, type: saLulnt16 

represents an index for a string item in the constant item pool, which specifies the full-qualified typename 
of the retumtype of the method. 
docu, type: saLulnt16 

represents an index for a string item in the constant item pool, which contains the documentation of this 

method. 

nParamCount, type: sal_ulnt16 

specifies the number of parameters for this method. If parameters exist, the parameter section follows this 

field. 

type, type: sal_ulnt16 

represents an index for a string item in the constant item pool, which specifies the full-qualified typename 
of the parameter. 

mode, type: sa!_ulntl6 

specifies the mode of the method, e.g., in, out or inout. 
name, type: sal_ulnt16 

represents an index for a string item in the constant item pool, which specifies the name of the parameter. 
nExceptionCoun t, type: sal_ uint 1 6 

specifies the number of exceptions for this method. If exceptions exist the exception section follows this field . 
excpName 1 . . . n, type: saLulntIG 

represent Indices for string items in the constant item pool, which specifies the full-qualified name-of ex- 
ceptions. 



Reference section 



[0764] The reference section represents type information for references in services. This section only exists if the 
field nReferenceCount is greater than zero. 
nReferenceCount, type: sal_ulnt16 

specifies the number of references for this type. 
nReferenceEnthes, type: sal_ulnt16 

specifies the number of fields for each entry in the reference section. This number is used for calculating 
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the offsets in the reference section. 
typename, type: saLulnt16 

represents an index for a string item in the constant item pool, which specifies the full-qualified typename 
of the reference. 
5 name, type: sal_ufnt16 

represents an index for a string item in the constant item pool, which specifies the name of the reference, 
docu, type: sal_ulnt16 

represents an index for a string item in the constant item pool, which contains the documentation of this 

reference. 

1 0 access, type: saLuInt 1 6 

specifies the access of the reference, e.g. needs, observes or interface. 
[0765] In one embodiment of a type repository, all functions or type declarations have a prefix "typelib,". In one 
embodiment of the type repository API. a function typelib^TypeDescription^newlnterface is used to create an interface 
description. "Hie descriptions of structures, unions and sequences are created with a function 

15 typelib_TypeDescription_new. The description of a base type is initially part of type repository. A function that gets a 
type description is function typelib_TypeDescription_getByName in the type repository API. 

[0766] A JAVA API to a type repository is different for two reasons. First, the JAVA classes cannot access the binary 
representation of the type descriptions directly. Second, the JAVA runtime system provides an API (core reflection) 
similar to the type repository API. Unfortunately, the features "unsigned", "oneway" and "out parameters" are missing 
20 in this API. For this reason, additional infomiation is written into the JAVA classes to provide the functionality of these 
features. 

[07671 The representation of the types depends on the hardware, the language and the operating system. The base 
type is swapped, for example, if the processor has little or big endian format. The size of the types may vary depending 
on the processor bus size. The alignment is processor and bus dependent. The alignment of the data stmcture is 
25 defined as follows: 

[0768] Structure members are stored sequentially in the order in which the structure members are declared. Every 
data object has an alignment-requirement For a structure, the alignment requirement is determined the largest object 
of the structure. Every object is allocated an offset so that offset % alignment-requirement == 0. 
[0759] If it is possible that the maximum alignment can be restricted (MICROSOFT C/C++ compiler, IBM C/C++ 
30 compiler), the maximum alignment is set to eight. Under this condition, the alignment is set to min( n, sizeof( item ) ) 
where n is maximum alignment. The size is rounded up to the largest integral base type. For the MICROSOFT and 
IBM C/C++ compiler the alignment of a structure is set to eight using the "#pragma" statement. 
[0770] Table 5 shows the type and type definitions for one embodiment of the UNO. C++ and the JAVA execution 
environments. 

35 

Table 98. 







Environment 




Type 


UNO 


C++ 


JAVA 


Byte 


Signed 8 Bit 


Signed 8 Bit 


Signed 8 Bit 


Short 


Signed 16 Bit 


Signed 16 Bit 


Signed 16 Bit 


Ushort 


Unsigned 16 Bit 


Unsigned 16 Bit 


Signed 16 Bit 


Long 


Signed 32 Bit 


Signed 32 Bit 


Signed 32 Bit 


Ulong 


Unsigned 32 Bit 


Unsigned 32 Bit 


Signed 32 Bit 


Hyper 


Signed 64 Bit 


Signed 64 Bit 


Signed 64 Bit 


Uhyper 


Unsigned 64 Bit 


Unsigned 64 Bit 


Signed 64 Bit 


Float 


Processor dependent: Intel, 
Sparc = IEEE float 


Processor dependent: Intel. 
Sparc = IEEE float 


IEEE float 


Double 


Processor dependent: Intel, 
Sparc = IEEE double 


Processor dependent: Intel, 
Sparc = IEEE double 


IEEE double 
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Table 98. (continued) 









Environment 






Type 


UNO 


C++ 


JAVA 


5 
10 


Enum 


The size of a machine word. 
Normally, this is the size of an 
integer. 


The size of a machine word. 
Nomially, this Is the size of an 
integer, 


All enum values of one enum . 
declaration are a static object of 
a class. Each object contains a 
32-bit value, which represents 
the enumeration value. 


Boolean 


1 Byte. 


1 Byte. 


Boolean 




Char 


16 Bit on WNT W95. W98. and 
Os2. 32 Bit on Unix 


16 Bit on WNT, W95. W98, and 
Os2. 32 Bit on Unix 


Unsigned 16-bit (char) 


15 
20 


String 


A pointer to a 
structure which have the 
following members: long 
refCount; long length; wchar_t 
bulTer[...j; The string in Duffer is 
0 terminated. This is the 
rtl_wString stmcture in the rtl- 
library 


A pointer to a 
structure which have the 
following members: long 
refCount; long length; wchar_t 
buTfert...]; The string in buffer is 
0 terminated. This is the 
rtLwString stmcture in the rtl- 
library 


java.lang. String 


25 


Structure 


The structure contains the 
members in the order of the 
declaration. 


The structure contains the 
members in the order of the 
declaration. . 


A class, which is derived from 
java.lang. Object and contains 
the members in the specified 
order. 


30 


Union 


The size is 4 + size of the 
largest type. In front of the 
union members is a long value 
(n Select), which describes the 
position of the valid member (0 
IS the Tirst). 


The size is 4 + size of the largest 
type. In front of the union 
members is a long value 
(nSelect). which describe the 
position of the valid member (0 
IS the tirst). 


Not specified 


35 
40 


Sequence 


A pointer to a structure which 
has the following members: 
void * pElements; long 
hElements; long n RefCount; 
The pElements are a memory 
area that contains nElements 
elements. 


A pointer to a structure which 
has the following members: void 
* pElements; long nElements; 
long nRef Count; The pElements 
are a memory area that contains 
nElements elements. 


A nonmal JAVA an-ay. 


45 


Exception 


Looks like a structure 


Looks like a structure 


A class, which is derived fmm 
java.lang. Except ion and 
contains the members in the 
specified order 


50 
55 


Interface 


Is a pointer to a function table, 
which contains at least three 
functions. 


Is a pointer to a C++-Class 
which implements first the 
virtual methods querylnterface, 
acquire and release. 


A normal JAVA interface. 


Any 


A structure that contains a 
pointer to a type description. 
The second member is a 
pointer to the value stored in 
the any. 


A structure that contains a 
pointer to a type description. 
The second member is a pointer 
to the value stored in the any. 


A class which is derived from 
"java.lang.Objec r. The 
members are a class, which 
describe the type of the value. A 
second member which is the 
value of the any. 




Void 


No memory representation 


No memory representation 


No memory representation 
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[0771] Many of the types in TABLE 5 are self-explanatory and known in the art. Nevertheless, the most relevant 
types are explained in more detail below. 

Interfaces: 

5 

[0772] All interfaces employed in connection with the present embodiment are derived from a super-interface class. 
Each, interface contains at least three methods. Two methods "acquire" and "release" are necessary to control the 
lifetime of the Interface. A third method "query! nterf ace" is used to navigate between different interfaces. In the UNO 
environment, an interface XInterface includes only these three methods. All other interfaces in the UNO environment 

10 are derived from this interface XInterface. 

[0773] In a JAVA environment, for example, interfaces are mapped to JAVA interfaces, which could be nomnally 
implemented. Methods acquire and release are not mapped to the JAVA program, since these methods do not exist 
in the JAVA programming language The lifetimes of the proxy and the relevant information in a second JAVA program 
are controlled by a garbage collector, and so methods acquire and release are not needed. The JAVA programming 

15 language delivers basic types by value and non-basic types by reference. All calls are specified by value except inter- 
faces. In a JAVA environment, all non-basic types returned or delivered through out parameters are by value, which 
means that the implementation must copy any non-basic types before return or deliver 

[0774] In a C++ environment, for example, interfaces are mapped to pure virtual classes. To automatically control 
the lifetime of interfaces a template called "Reference" Is used. All return, parameter and member types are "Refer- 
20 ences" (e.g.: Reference< XInterface >). The "Reference" acquires the interface when it is constructed, and releases 
the Interface when It is destructed. 

Structure: 

25 [0775] A structure is a collection of elements. The type of each element is fixed and it cannot be changed. The 
number of elements is fixed. 

Exceptions: 

30 [0776] An exception is a program control construct besides the normal control flow. One major feature of exceptions 
Is that with exceptions, implementation of the error handling is simpler. Exceptions are similar to structures since ex- 
ceptions are also a collection of elements and each type of each element is fixed and cannot be changed and the 
number of elements is also fixed. An additional feature of exceptions is that exceptions can be thrown by a method. 
All exceptions, which can be thrown by a method, must be declared at the method, except for the exception Runtime- 

35 Exception, which always can occur. All exceptions must be derived from interface Exception in the UNO environment 
(See CHAPTER A). If an exception is declared at a method, the method is allowed to throw all derived exceptions. 
The caller of a method must respond to this behavior. 

[0777] In the JAVA environment, for example, all exceptions are derived from exception java.lang. Exception. The 
exceptions are declared at the methods. In the C++ environment, for example, the exceptions are generated as struc- 
40 tures. An exception is thrown as an instance (e.g.: throw RuntimeExceptionO)- At the other side, the exception should 
be caught as a reference (...catch(RuntimeException &){... })■ 

Union: 

45 [0778] A union contains one element. The declaration of a union specifies the possible types. 
Array: 

[0779] An an^y contains any numt)er of elements. The type of the elements is fixed and cannot be changed. 

50 

Any: 

[0780] An any contains one element. All types of elements are possible. An any contains a reference to the value 
and the type description of the type. With the type description, the bridge can transform the value, if necessary. In the 
55 JAVA environment, the any is, for example, represented by class Any, which contains a class as type description and 
a value, which is "java.lang.Objecr. The basic types are wrapped to their proper classes. For example, a Boolean 
value is an object of the class "java.lang. Boolean", which contains the value. 

[0781 ] In the C++ environment, the any is represented through class Any. Each type generated by a C++ code maker 
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implements a function "getCppuType". This function is used to implement the template access operators and 
These operators insert and extract the value of the any. 

Sequence: 

[0782] A sequence is a generic data type. A sequence contains the number of elements and the elements. In the 
JAVA environment, the specification of an array fulfills this specification. This is not true for the C++ environment. An 
array in the C++ programming language does not contain the number of elements. It is not possible to return a C++- 
array, e.g., Charfl getName() is not possible. It is difficult to manage the lifetime between the called and the caller, if 
only a pointer is returned. Therefore, in the C++ programming language, a sequence is a template with the name 
Sequence. The implementation contains a pointer to a structure, which contains a pointer to the elements, the number 
of elements and the reference count. Thus, the implementation of the template holds the binary specification. It is 
cheap to copy this sequence, because only the reference count is incremented. 

Creating and using a Proxy Interface 

[0783] With this understanding of an execution environment, and the various types that may be associated with an 
execution environment, a description of making and using one embodiment of a bridge including a proxy interface is 
now described. A bridge includes two mappings. Each mapping is dependent upon the counterpart mapping, because 
performing a call may require conversion of interfaces ft'om one environment to the other environment, e.g., input 
parameters to an interface , and/or return values ft-om an interface. Thus, a bridge implements infrastructure to exchange 
interfaces between two environments and is bi-directional. 

[0784] Figure 4 is a sequence diagram for one embodiment the present invention. Along the horizontal axis are 
individual objects, where each object is represented as a labeled rectangle. For convenience, only the objects needed 
to explain the operation are included. The vertical axis represents the passage of time fi-om top to bottom of the page. 
Horizontal lines represent the passing of messages between objects. A dashed line extends down from each rectangle, 
and a rectangle along the dashed line represents the lifetime of the object. 

[0785] To make calls to a first binary specification for an execution environment, the execution environment has to 
be denominated. In one embodiment, an execution environment is denominated by a string, because the string is 
extensible and the risk of double names is low. Example of strings used to denominate execution environments are 
presented in Table 6. 



TABLE 99.: 



EXAMPLES OF STRINGS USED TO DENOMINATE EXECUTION ENVIRONMENTS 


LANGUAGE BINDING OR OBJECT MODEL 


NAMING 


Binary UNO 


uno 


JAVA 


Java 


MICROSOFT C++ 4.2 - 6.0 


msci 


EGCS 2.9.1 with RTTI 


egcs29 


Woricshop Compiler 5.0 


sunproS 


COM 


com 



[0786] Each bridge is implemented in a separate shared library that is loaded at runtime. One naming scheme of 
the library is a concatenation as follows: 

[purpose_]SourceEnvName_DestEnvName 

[0787] The optional purpose denotes the purpose of the bridge, e.g.. protocol ling traffic between two environments. 
If no purpose is given, the bridge maps interfaces from the source environment to the destination environment. 
[0788] Hence, in this embodiment, user object 401 calls a method GetEnvironment. with a string denominating the 
source environment as a parameter, in runtime library 402. In response to the call, a source environment object 403 
is instantiated and registered by runtime library 402. 

[0789] User object 401 calls a method GetEnvironment, this time with a string denominating the destination environ- 
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ment as a parameter, In runtime library 402, In response to this call, a destination environment object 404 is instantiated 
and registered by runtime library 402. 

[0790] Next user object 401 calls a method getMapping in runtime library 402. A first parameter in the method call 
is the string denominating the source environment. A second parameter In the method call is the string denominating 

5 the destination environment. 

[0791] In response to the call to method getMapping, a bridge object 405 is activated by runtime library 402. In one 
embodiment, a shared library Is searched to find a library that contains a proxy factory for the specified source and 
destination environments. In a JAVA execution environment, the search is for a dass with a name associated with the 
source and destination environments. The shared bridge library cannot be unloaded while any of its code is still needed. 

10 So both mappings and any wrapped interface (proxy) that are exported need to modify a shared bridge library wide 
reference count. If the shared bridge library can be unloaded the reference count goes to zero. 
[0792] After bridge object 405 is activated, user object 401 issues a call to a method Mapping. maplnterface with a 
first parameter that is a source interface, and a second parameter that is a type. After receiving the call to method 
Mapping.maplnterface, bridge object 405 issues a call to method sourceEnv.getObjectldentifier of source environment 

15 object 403 for the type. An object identifier is returned for the type, e.g., for an interface, and bridge object 405 issues 
a call to method destEnv.getRegisteredlnterface of destination environment object 404 with the object identifier and 
the type as input parameters. 

[0793] If a proxy interface is registered in destination environment object 404 for this object identifier and type, a 
pointer to the proxy is returned by method getRegistered Interface. In this example, a pointer to the proxy interface 406 
20 is returned to user object 401 . 

[0794] Conversely, if method getRegistered Interface failed to find a registered proxy interface, bridge object 405 
calls method create proxy with a source environment and a type as input parameters. In creating a proxy, bridge object 

405, in one embodiment, uses a proxy factory to generate method code to implement each method specified in the 
interface to be created. The only information to do this is a type description of the interface. For example, in a JAVA 

25 environment, a binary class file (*. class) is generated and loaded with the class loader. In the absence of a loader, 
which can directly load binary classes, a loader has to be provided. In a C++ environment, virtual method tables are 
generated, which delegate each call to the interface in the source environment. 

[0795] The knowledge of the type description is necessary to create the proxy, as described. This type description 
is the full description of the limited functionality, e.g.. a description of an interface, in the source execution environment. 
30 The type description may refer one of the different types shown in Table 5: 

[0796] Following creation of the proxy, bridge object 405 registers the interface with source environment object 403 
and registers the proxy interface with destination environment object 404. This completes creation of proxy interface 

406, sometimes called proxy 406. 

[0797] To use proxy interface 406, user object 401 simply calls a method in proxy interface 406. In response to the 
35 call, proxy interface 406 converts any input parameters as necessary using the method type description, and marshals 
the arguments for source interface 407. Next, proxy interface 406 dispatches a call to the method in source interface 
407 in the source execution environment. 

[0798] The method is executed in the source environment and the results are returned by source interface 407 to 
proxy interface 406. Upon receiving a return for the call, proxy interface 406 checks for any exceptions and if there are 

40 none, converts any output parameters and the return value to the destination execution environment again using the 
method type description, and then returns the results to user object 401. Thus, user object 401 has transparently 
accessed functionality in another execution environment. Typically, this is limited functionality, as described above. 
[0799] In the following description, a specific example of a bridge that maps an interface from a MICROSOFT Visual 
C++ environment to a UNO environment is first described, and that maps an interface from a UNO environment to a 

45 MICROSOFT Visual C++ environment is described second. Table 7 is an example of a call to a method bar in the UNO 
interface XExample from a C++ program. 



50 



55 
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TABLE 100.: EXAMPLE of C++ PROGRAM SEGMENT TO GENERATE 
and USE A PROXY 



Mapping aMapping ( "uno", "msci" ); 

XExample * pExample = (XExample *) 

aMapping .maplnterf ace ( pUnoExample, 

: : getCppuType ( (const Reference < XExample > *) 0 

) ) ; 

pExample->bar ( ) ; 



pExampie->release; 



[0800] For the example of Table 7. the initial call to function Mapping creates a bridge from the UNO environment to 
the MSCI environment The generation of the bridge, In this example uses, methods InitEnvironment and getMapping. 
Table 8 is the implementation of these methods that are used in the proxy class of Table 9, for this example. 
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TABLE 101.: EXAMPLE OF DECLARATION OF METHODS 
initEnvironment and getMapping. 



extern "C" SAL^DLLEXPORT void SAL_CALL 

uno_initEnvironment ( uno_Environment * pCppEnv ) 

( 

CPPU_CURRENT_NAMESPACE: : cppu_cppenv_initEnvironment ( 
pCppEnv ) ; 

\ 

extern ."C" SAL_DLLEXPORT void SAL^CALL 

uno_ext_getMapping ( uno^Mapping ppMapping, 
uno_Environment * pFrom, uno_Environment * pTo ) 

{ 

CPPU_CURRENT_NAMESPACE : : cppu_ext_getMapping ( ppMapping, 
pFrorti/ pTo ) ; 
) 



[0801] As explained above, to process a call to a method of a UNO interface in the C++ environment, there must be 
a proxy C++ object that delegates the method call to the corresponding UNO interface. Table 9 is bridge header file 
example of a bridge class, a C++ to UNO proxy class, and a UNO to C++ proxy class that can be modified for a specific 
environment. This example uses the bridge object and C++ to UNO proxy object that are instantiated using the classes 
in Table 9. As explained above, the call to method Mapping.maplnterface creates a proxy interface. 
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TABLE 102.: EXAMPLE OF A CLASS DEFINITIONS 



namespace CPPU_CURRENT_NAiyiESPACE 
{ 

// these have to be defined in some C file in the 
// current namespace (See Tables 10 & 16) 
void SAL__CALL cppu_cpplnterf aceProxy_patchVtable ( 
:: com: : sun: : star :: uno: iXInterface * pCppI, 
typelib_InterfaceTypeDescription * pTypeDescr ) ; 
void SAL_CALL cppu_unoInterf aceProxy_dispatch ( 
uno_Interf ace * pUnoI, const 

typelib_TypeDescription * pMemberDescr, void * 
pReturn, void * pArgs[], uno_Any ** ppException ); 

struct cppu_Bridge; 

struct cppu_Mapping : public uno_Mapping 
{ 

cppu_Bridge * pBridge; 

inline cppu_Mapping( eppu_Bridge * pBridge, 
uno_MapInterf aceFunc fpMap ) ; 



holding environments and mappings ============= 

struct cppu_Bridge 
{ 



OS 1 Inter lockedCount 



nRef ; 



uno ExtEnvironment * 



pCppEnv; 
pUnoEnv; 
aCpp2Uno; 
aUno2Cpp; 



uno ExtEnvironment * 



cppu_Mapping 
cppu_Mapping 
sal_Bool 

void SAL_CALL acquire (); 
void SAL_CALL release () ; 



bExportCpp2Uno; 
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inline cppu_Bridge ( uno_ExtEnvironment * pCppEnv_, 
uno_ExtEnvironment * pUnoEnv_, sal_Bool 
bExportcpp2Uno_ ) ; 

}; 

//==== a cpp proxy wrapping an uno interface ========= 

struct cppu_cppInterfaceProxy : public 
: :com: :sun: :star: :uno: :XInterface 

{ 

oslInterlockedCount nRef; 
cppu_Bridge * pBridge; 
// mapping information 

uno_Interface * pUnoI; // wrapped interface 

typelib_InterfaceTypeDescription * pTypeDescr; 

: : rtl: rOUString oid; 

// non virtual methods called on incoming vtable calls 

// #1, #2 

inline void SAL_CALL. acquireProxy ( ) ; 

inline void SAL_CALL releaseProxy ( ) ; 

// XInterface: these are only here for dummy, there 
will be a patched vtable! 

// dont use this, use cppu_querylnterf ace ( ) ! 

virtual :: com: : sun: : star :: uno: : Any SAL_CALL 

querylnterf ace ( const : : com: : sun: : star: : uno : :Type 
& ) { return :: com: : sun: : star : :uno: : Any () ; } 

// dont use this, use cppu^acquire ( ) ! 

virtual void SAL_CALL acquire () {} 

// dont use this, use cppu_release ( ) ! 

virtual void SAL_CALL release {) {} 

// ctor 

inline cppu_cpplnterf aceProxy ( cppu_Bridge * pBridge_, 
uno_Interf ace * pUnoI_, 

typelib_InterfaceTypeDescription * pTypeDescr_, 
const : : rtl : :OUString & rOId__ ); 

};■ 

//= a uno proxy wrapping a cpp interface ==== 
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struct cppu_unoInterfaceProxy : public uno_Interf ace 
{ 

oslInterlockedCount nRef; 
cppu_Bridge * pBridge; 

// mapping information 

: :com: :sun: : star : :uno: rXInterface * pCppI; // 

wrapped interface 
typelib^Interf aceTypeDescription * pTypeDescr; 
: :rtl: lOUString oid; 
// ctor 

inline cppu_unoInterf aceProxy ( cppu_Bridge * pBridge_, 
:: com: : sun: : star : :uno: :XInterf ace * pCppI__r 
typelib_InterfaceTypeDescription * pTypeDescr_, 
const :: rtl : lOUString & rOId_ ); 

}; 

// 

inline void SAL_CALL cppu_cppenv_initEnvironment ( 

uno_Environment * pCppEnv ) ; 
// 

inline void SAL_CALL cppu_ext_getMapping ( uno_Mapping 
** ppMapping, uno_Environment * pFrom, 
uno_Environment * pTo ) ; 



} 



[0802] The proxy object is instantiated and the vtable pointer is modified to give a generic vtable. For a MICROSOFT 
C++ environment, the generic vtable can be used because an objects' this pointer is at anytime the second stack 
parameter (See Fig. 6). However, for gccor sunproS (See Table 6), the first parameter may the pointer to a struct return 
space. Thus, for there compilers, a vtable for each type that is used must be generated. 

[0803] As explained more completely below, when the proxy interface is called, a vtable index is determined by the 
generic vtable (See Figs. 7A and 7B), and based upon this index, the method type description is detemilned. This 
method type description is the information that Is used to get the values from the processor call stack and perform a 
dispatch call on the target UNO interface that the C++ proxy is wrapping. 

[0804] After the dispatch call, the returned exception information is checked to determine whether a C++ exception 
has to be generated and raised. If no exception has occurred, the inout/out parameters are reconverted. In this example, 
the reconversion of inout/out parameters is only Important for values representing interfaces or values containing in- 
terfaces, because the values of all objects in the UNO environment are binary compatible on a spedfic computing 
architecture. 

(08051 The C++ proxy, as defined by Table 9, holds the interface origin, i.e., the target UNO interface. Thus, the C++ 
proxy can register with the C++ environment on the first execution of method acquire, and can revoke itself on its last 
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execution of method release from its environment. 

[0806] The C++ proxy manages a reference count for the proxy, a pointer to the bridge of the C++ proxy to obtain 
the counterpart mapping, the UNO interface the C++ proxy delegates calls to, the (interface) type the C++ proxy is 
emulating, and an object identifier (oid). The type and object identifier are needed to manage objects from environments, 
for proof of object identity, and to improve performance. A proxy to an Interface is not needed if there is already a 
registered proxy for that interface. 

[0807] When the proxy object is created by the MICROSOFT Visual C++ compiler, the vtable is patched by the 
execution of method patchVtable. One embodiment of method patchVtable is presented in TABLE 10. 

TABLE 103,: EXAMPLE OF METHOD patchVtable 



void SAL__CALL cppu_cpplnterf aceProxy_patchVtable ( 
XInterface * pCppI, 

typelib_InterfaceTypeDescription * pTypeDescr ) 

( 

static MediateVtables * s_pMediateVtables = 0; 

if (! s_pMediateVtables) 

{ 

MutexGuard aGuard( Mutex: :getGlobalMutex ( ) ); 

if (! s_pMediateVtables) 

{ 

#ifdef LEAK_STATIC_DATA 

s__pMediateVtables = new MediateVtables () ; 

#else 

static MediateVtables s__aMediateVtables ; 

s_pMediateVtables = &s_aMediateVtables ; 
#endif 
} 
} 

* (const void **)pCppI = s_pMediateVtables- 
>getMediateVtable { pTypeDescr- 
>nMapFunctionIndexToMemberIndex ) ; 

) 



[0808] An embodiment of the class MediateVtables that Is used to instantiate the object MediateVtables in method 
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EXAMPLE OF CLASS MediateVtables 



struct DefaultRTTIEntry 
{ 

sal_Int32 _nO, _nl, _n2; 
type_info * _pRTTI; 
.DefaultRTTIEntry ( ) 
: _nO{ 0 >, 

_nl( 0 ), 

_n2( 0 ) 

{ _pRTTI = msci_getRTTI ( "com. sun. star . uno.XInterface" 
); } 

); 

typedef list<void * > t_pSpacesList ; 
Mutex _aMutex; 
t^pSpacesList _aSpaces; 
sal_Int32 _nCurrent; 
const void * _pCurrent; 
public : 

const void * getMediateVtable ( sal_Int32 

nSize ) ; 

MediateVtables ( sal_Int32 nSize = 256 ) 
: _nCurrent ( 0 ) 
, _pCurrent( 0 ) 
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{ getMediateVtable { nSize ); } 
-MediateVtables ( ) ; 

); 

//_ 

MediateVtables : : -MediateVtables ( ) 
{ 

TRACE ( "> calling -MediateVtables {) : freeing mediate 

vtables. . . <\n" ) ; 
MutexGuard aGuard( _aMutex ); 

// this MUST be the absolute last one, which is called! 
for ( t_pSpacesList :: iterator iPos( _aSpaces . begin ( ) ); 
iPos != _aSpaces.end() ; ++iPos ) 

{ 

rtl_f reeMemory { *iPos ); 
} 

} 



[0809] TABLE 12 is an example of one embodiment of a method getMediateVtable that is called in the embodiment 
of method patchVtable of TABLE 10. 

TABLE 105.: EXAMPLE OF METHOD getMediateVtable 



const void * MediateVtables :: getMediateVtable ( 
sal_Int32 nSize ) 

{ 

if (_nCurrent < nSize) 
{ 

TRACE ( "> need larger vtable! <\n" ); 
// dont ever guard each time, so ask twice when guarded 
MutexGuard aGuard( _aMutex ); 
if (_nCurrent < nSize) 
{ 
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nSize = (nSize +1) & Oxfffffffe; 

char * pSpace = (char * ) rtl_allocateMemory ( 

{ (l+nSize) *si2eof (void *)) + (nSi2e*12) ); 
_aSpaces-push_back( pSpace ); 
// on index -1 write default rtti entry 
static DefaultRTTIEntry s^defaultlnterf aceRTTI ; 
*(void **) pSpace = &s_def aultlnterf aceRTTI ; 
void ** pvft = (void **) (pSpace + sizeof(vGid *) ) ; 
char * pCode = pSpace + ( (1+nSize) *sizeof (void *)); 
// setup vft and code 

for ( sal_Int32 nPos = 0; nPos < nSize; ++nPos ) 

( . 

unsigned char * codeSnip = (unsigned char *)pCode + 

(nPos *12) ; 

pvft[nPos] - codeSnip; 
/ *- * 

* vtable calls detonate on these code snippets 
*/ 

// mov eaxr nPos 
*codeSnip++ = Oxb8; 
*(sal_Int32 *) codeSnip = nPos; 
codeSnip += sizeof (sal_Int32) ; 
// jmp rel32 cpp_vtable_call 
*codeSnip++ ^= Oxe9; 

*{sal_Int32 *) codeSnip = ((unsigned char 

*) cpp_vtable_call) - codeSnip - sizeof (sal_Int32) ; 

} 

_pCurrent = pSpace "+ sizeof (void *) ; 

_nCurrent = nSize; 

} 

} 

return _pCurrent; 
) 



[0810] Figure 6 is an example of a call stack 600 of a virtual function call that Is stored in a memory 61 0 of computer 
system 100 (Figs. 1A and IB). The left-hand column Is the stack offset for the start of storage location, and the right 
hand column gives the value stored at each storage location. 
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[08111 The vtable for the C++ proxy, i.e.. a function pointer array to perform polymorphic calls on C++ objects, de- 
termines which function should be called. Figure 7A is an illustration of the vtable for this example that correlates the 
slots in the table to the methods handled by the C++ proxy. Recall, that every proxy has to Inherit the methods from 
UNO interface XInterface. which are methods acquire, release, and query! nterf ace. 

[0812] When the call to method bar (Table 7) is executed, the call is directed to the C++ proxy. The only task of the 
proxy vtable is to determine the call Index of the UNO method that Is to be called. (See Fig. 7B) 
[0813] Figure 8 is a process flow diagram of one embodiment of the operations performed by a proxy 130 or 130A 
that in this example is the C++ proxy. When method bar is called, process 800 (Fig. 8) is started in operation 801. 
[0814] Initially, in determine slot operation 802 the C++ proxy executes method patch Vtable (See Table 10) that in 
turn calls method getMediateVtable (See Table 12). Method getMedlateVtable reaches an assembler snippet that 
determines the vtable slot of method bar and calls method vTable 810. This completes operation 802. 
[081 5] TABLE 1 3 is an example of one implementation of method vTable 810. 
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TABLE 106.: AN EXAMPLE OF METHOD vTable 



/ * * 

* is called on incoming vtabie calls 

* (called by asm snippets) 
*/ 

static declspec (naked) void cdecl 

cpp_vtable_call (void) 

{ 

asm 

{ 

sub esp, 8 // space for 

immediate return type 
push esp 

push eax // vtabie index 

mov eax, esp 

add eax, 16 

push eax // original stack ptr 

call cpp_mediate 
add esp, 12 



cmp eax, typelib_TypeClass_FLOAT 

je Lfloat 

cmp eax, typelib_TypeClass__DOUBLE 

je Ldouble 

cmp eax, typelib_TypeClass_HYPER 

je Lhyper 
cmp eax, 
typelib_TypeClass_UNSIGNED_HYPER 
je Lhyper 
// rest is eax 
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10 



15 



20 



25 



30 



Lhyper : 



Lfloat : 



Ldouble : 



pop 
add 
ret 

pop 
pop 
ret 

fid 
add 
ret 

fid 
add 
ret 



eax 
esp, 4 



eax 
edx 



dword ptr [esp] 
esp, 8 



qword ptr [esp] 
esp, 8 



[081 6] Operation 802 transfers processing to prepare stack operation 811 In method mediate 81 0. In operation 811. 
the stack space is prepared for register data, and then processing passes to call mediate operation 812. 
35 [0817] Call mediate operation 812 calls method mediate that in turn looks up the called vtable index, gets the attribute 
or method type description, and calls a method that dispatches that actual call to the method in the UNO environment. 
A process flow diagram of one embodiment of method mediate 900 is presented in Figure 9. Table 1 4 is an example 
of method mediate. 



40 
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TABLE 107.: EXAMPLE OF METHOD mediate 



static typeIib_TypeClass cdecl cpp_mediate ( void ** 

pCallStack, sal_Int32 nVtableCall, sal_Int64 * 
pRegisterReturn /* space for register return */ ) 

{ 

OSL__ENSHURE( si zeof ( sal_Int32 ) ==si2eof (void *), "### 

unexpected! " ) ; 
// pCailStack: ret adr, this, [ret *], params 
// _this_ ptr is patched cppu_XInterf aceProxy object 
cppu_cppInterfaceProxy * pThis = static_cast< 

cppu^cppInterfaceProxy * >( reinterpret_cast< 

XInterface * >( pCallStack [1] ) ); 
typelib_Interf aceTypeDescription * pTypeDescr = pThis- 

>pTypeDescr; 
OSL_ENSHURE ( nVtableCall < pTypeDescr- 

>nMapFunctionIndexToMemberIndex, "### illegal 

vtable index!" ); 
if (nVtableCall >= pTypeDescr- 

>nMapFunctionIndexToMember Index) 

{ 

throw RuntimeException ( OUString ( 

RTL_CONSTASCII_USTRINGPARAM ( "illegal vtable 
index!") ), (XInterface *)pThis ); 

} 

// determine called method 
sal_Int32 nMemberPos = pTypeDescr- 

>pMapFunctionIndexToMemberIndex [nVtableCall] ; 
OSL_ENSHURE( nMemberPos < pTypeDescr->nAllMembers, "### 

illegal member index!" ); 
TypeDescript ion aMemberDescr ( pTypeDescr- 

>ppAllMembers [nMemberPos] ) ; 
typelib_TypeClass eRet; 
switch (aMemberDescr -get () ->eTypeClass) 
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break; 

case 2: // releaseO 

pThis->releaseProxy ( ) ; // non virtual call! 

eRet = typelib_TypeClass_VOID; 

break; 

case 0: // querylnterface ( ) opt 

{ 

typelib_TypeDescription * pTD = 0; 

TYPELIB_DANGER__GET( &pTD, reinterpret_cast< Type * >( 

pCallStack[3] ) ->getTypeLibType ( ) ) ; 
OSL_ASSERT.( pTD ) ; 
XInterface * pinterface = 0; 

( *pThis->pBridge->pCppEnv->getRegisteredInterf ace) { 
pThis->pBridge->pCppEnv, (void **) Splnterface, 
.pThis->oid. pData, 

(typelib_Interf aceTypeDescription *)pTD ); 
if (pinterface) 

{ 

uno_any_construct ( reinterpret_cast< uno_Any * >( 

pCallStack[2] ), fiplnterface, pTD, cpp__acquire 
) ; 

pinterf ace->release { ) ; 

TYPELIB_DANGER_RELEASE ( pTD ); 

* {void **)pRegisterReturn = pCallStack [2 ] ; 

eRet = typelib_TypeClass_ANy; 

break; 

} 

TYPELIB_DANGER_RELEASE ( pTD ) ; 

} // else perform querylnterface ( ) 

default: 

eRet - cpp2uno_call ( 

pThis, aMemberDescr . get ( ) , 

( ( typelib_Interf aceMethodTypeDescription 
* ) aMemberDescr . ge t ( )-) ->pReturnTypeRef , 
( ( typelib_Interf aceMethodTypeDescription 
*) aMemberDescr .get (.) ) ->nPararas, 
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{ 

case typelib_TypeClass_INTERFACE_ATTRIBUTE : 

{ 

if (pTypeDescr- 

>pMapMemberIndexToFunctionIndex [nMemberPos] 
nVtableCall) 

{ 

// is GET method 

eRet = cpp2uno_call ( pThis, aMemberDescr , get ( ) , 
( (typelib_InterfaceAttributeTypeDe script ion 
*) aMemberDescr -get () ) ->pAttributeTypeRef , 0, 
pCallStack, pRegisterReturn ) ; 

} 

else 
{ 

// is SET method 

typelib_MethodParameter aParam; 

aParam . pTypeRef 

= ( (typelib_InterfaceAttributeTypeDescription 
* ) aMemberDescr . get ( ) ) ->pAttributeTypeRef ; 

aParam.bin = sal_True; 

aParam. bOut = sal_False; 

eRet = cpp2uno_call ( pThis, aMemberDescr . get (), 0, 
&aParam, pCallStack, pRegisterReturn ) ; 

) 

break; 
} 

case typelib_TypeClass_INTERFACE_METHOD: 
{ 

// is METHOD 

switch (nVtableCall) 

{ 

// standard XInterface vtable calls 
case 1: // acquire () 

pThis->acquireProxy 0 ; // non virtual call! 

eRet = typelib_TypeClass_VOID; 
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( (typelib_InterfaceMethodTypeDescription 
*) aMemberDescr.get () )->pParams, pCallStack, 
pRegisterReturn ) ; 

} 

break; 
} 

default: 
{ 

throw RuntiineException( 

oust ring { RTL_CONSTASCII_USTRINGPARAM ( "no member 

description found!") ), (Xlnterface *)pThis ); 
// is here for dununy 
eRet = typelib_TypeClass_VOID; 
} 
} 

return eRet; 
} 



30 

[0818] Method call check 901 of method mediate 900 detemnines whether the call is a method call. If the call is a 
method call processing transfers to acquire/release check operation 910, and otherwise to attribute get check operation 
920. 

[0819] Acquire/release check operation 910 branches to acquire/release call operation 911 if the method call is a 
35 call to either method acquire or method release, because these calls can be executed without calling the interface in 
the source environment. If the method call is not a call to either method acquire or method release, processing transfers 
from check operation 910 to query interface check operation 912. 

Acquire/Release call operation 911 performs the appropriate method, which is a non-virtual call, and returns. 
[0820] Query interface check operation 912 detennlnes whether the method call Is to method query Interface. If the 
40 method call Is not to method querylnterface, check operation 912 transfers to call Env1_to_Env2 with Interface oper- 
ation 930 and otherwise transfers to registered interface available check operation 913. In the current example, the 
call to method bar results In check operation 912 transferring to operation 930. 

[0821] Nevertheless, to complete the description of this branch of method mediate 900, if there Is a registered inter- 
face in the source environment object for method querylnterface, check operation 913 transfers to set retunn value 

45 operation 914 and otherwise to call Env1_to_Env2 with Interface operation 930. Asking whether the Interface Is reg- 
istered in the source environment object is an optimization that eliminates a call to the actual interface in the source 
environment. Set return value operation 914 sets the registered interface as the retum value and returns. 
[0822] If the call to tiie C++ proxy was not a method call, check operation 901 transfers to attribute get check operation 
920. In this embodiment, there is either an attribute get or an attribute set. If the call to the proxy is an attribute get, 

50 check operation 920 ti-ansfers to prepare attribute get call operation 921 and othenwise transfers to prepare attribute 
set call operation 922. Both operations 921 and 922 set up the parameters for the call and transfer to call Envl _to_Env2 
with Interface operation 930. 

[0823] An embodiment of method Env1_to_Env2 with interface for the C++ proxy is presented in Table 15. Figure 
10 is a process flow diagram for one embodiment of method Env1_to_Env2 with interface. 

55 
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TABLE 108.: AN EXAMPLE OF METHOD Envl_to_Env2 with 
interface 



using namespace std; 
using namespace rtl; 
using namespace osl; 

using namespace com: : sun :: star :: uno; 
namespace CPPU_CURRENT_NAMESPACE 
{ 

static inline typelib_TypeClass cpp2uno_call ( 
cppu_cpplnterf aceProxy * pThis^ const 
typelib_Type Description * pMemberTypeDescr , 
typelib_TypeDescriptionRef erence * pReturnTypeRef , 
sal_Int32 nParams, typelib_MethodParameter * 
pParams, void ** pCallStack, 
sal_Int54 * pRegisterReturn ) 

{ 

// pCallStack: ret, this, [complex return ptr] , params 
char * pCppStack = (char *) (pCallStack +2) ; 
// return 

typelib_TypeDescription * pReturnTypeDescr = 0; 
if {pReturnTypeRef ) TYPELIB_DANGER__GET { 

&pReturnTypeDescr, pReturnTypeRef ) ; 
void * pUnoReturn =0; 

// complex return ptr: if != 0 && != pUnoReturn, 
// reconversion need 
void * pCppReturn = 0; 
if (pReturnTypeDescr) 
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I 

if {cppu_isSimpleType ( pReturnTypeDescr )) 
{ 

// direct way for simple types 
pUnoReturn = pRegisterReturn; 
) 

else // complex return via ptr (pCppReturn) 
{ 

pCppReturn = * (void **) pCppStack; 
pCppStack += sizeof(void *); 

pUnoReturn = {cppu_relatesToInterf ace ( pReturnTypeDescr 
) 

// direct way 
? alloca( pReturnTypeDescr'->nSize ) : pCppReturn); 

) 
} 

// stack space 

OSL_ENSHURE( sizeof (void *) == sizeof (sal_Int32) , "### 

unexpected size!" ); 
// parameters 

void ** pUnoArgs = (void **)alloca( 4 * sizeof (void *) 

* nParams ) ; 

void ** pCppArgs = pUnoArgs + nParams; 

// indices of values that have to be converted 

// (interface conversion cpp<=>uno) 

sal_Int32 * pTempIndizes = (sal_Int32 *) (pUnoArgs + (2 

* nParams) ) ; 

// type descriptions for reconversions 
typelib_TypeDescription ** ppTempParamTypeDescr = 

( typelib_TypeDescription **) (pUnoArgs + (3 * 

nParams) ) ; 
sal_Int32 nTempIndizes = 0; 

for ( sal_Int32 nPos = 0; nPos < nParams; ++nPos ) 
{ 

const typelib_MethodParameter & rParam = pParams [nPos] ; 
typelib_TypeDescription * pParamTypeDescr = 0; 
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TYPELIB_DANGER_GET ( &pParamTypeDescr , rParam.pTypeRef 
); 

if ( ! rParam.bOut && cppu_isSimpleType ( pParamTypeDescr 
) ) // value 

( 

pCppArgs [nPos] = pCppStack; 

pUnoArgs {nPos] = pCppStack; 

switch (pParamTypeDescr->eTypeClass ) 

{ 

case typelib_TypeClass_HyPER; 

case typelib_TypeClass_UNSIGNED_HYPER: 

case typelib_TypeClass_DOUBLE: 

pCppStack += sizeof (sal_Int32) ; // extra long 

} 

// no longer needed 

TYPELIB_DANGER_RELEASE( pParamTypeDescr ); 
} 

else // ptr to complex value I ref 

{ ' 

pCppArgsfnPos] = * (void **) pCppStack; 
if (! rParam.bin) // is. pure out 

{. 

// uno out is unconstructed mem! 

pUnoArgs [nPos] = alloca( pParamTypeDescr->nSize ); 
pTempIndizes [nTempIndizes] = nPos; 
// will be released at reconversion 

ppTempParamTypeDescr [nTempIndizes++] = pParamTypeDescr 
} 

//is in/inout 

else if (cppu_relatesToInterface { pParamTypeDescr )) 
{ 

uno_copyAndConvertData ( pUnoArgs [nPos] = alloca( 

pPararaTypeDescr->nSize * {void **) pCppStack, 
pParamTypeDescr, &pThis->pBridge->aCpp2Uno ) ; 

//has to be reconverted 

pTempIndizes [nTempIndizes] = nPos; 
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// will be released at reconversion 

ppTempParaitiTypeDescr [nTempIndizes++] = pParamTypeDescr 
} 

else // direct way 

{ ' 

pUnoArgs [nPos] = *(void **) pCppStack; 
// no longer needed 

TYPELIB_DANGER_RELEASE( pParamTypeDescr ); 

1 

} 

// standard parameter length 
pCppStack sizeof (sal_Int32) ; 
} 

// Except ionHolder 

uno__Any aUnoExc; // Any will be constructed by callee 
uno_Any * pUnoExc = &aUnoExc; 
// invoke uno dispatch call 
(*pThis->pUnoI->pDispatcher) ( pThis->pUnoI, 

pMemberTypeDescr, pUnoReturn, pUnoArgs, &pUnoExc 

) ; 

// in case an exception occurred- . . 

if (pUnoExc) 

{ 

// destruct temporary in/inout params 

while {nTempIndizes — ) 

{ 

sal_Int32 nindex = pTempIndizes [nTempIndizes] ; 
// is in/inout => was constructed 
if (pParamstnIndexJ.bin) 
uno_d€structData ( pUnoArgs [nindex] , 

ppTempParamTypeDescr [nTempIndizes] , 0 ); 
TYPELIB_DANGER_RELEASE ( 

ppTempParamTypeDescr [nTempIndizes] ) ; 

} 

if (pReturnTypeDescr) TYPELIB_DANGER_RELEASE ( 
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pReturnTypeDescr ) ; 
msci_raiseException ( &aUnoExc, &pThis->pBridge- 

>aUno2Cpp ) ; // has to destruct the any 
// is here for dummy 
return typelib_TypeClas5_V0ID; 
} 

else // else no exception occurred... 

{ 

// temporary pa rams 
while (nTempIndizes — ) 
( 

5al_Int32 nindex = pTempIndizes [nTempIndizes] ; 
typelib_TypeDescription * pParamTypeDescr = 

ppTempParamTypeDescr [nTempIndizes] ; 
if (pParams[nIndex] .bOut ) // inout/out 

{ - 

// convert and assign 

uno_destructData { pCppArgs [nindex] , pParamTypeDescr, 

cpp_release ) ; 
uno_copyAndConvertData ( pCppArgs [nindex] , 

pUnoArgs [nindex] , pParamTypeDescr, &pThis- 

>pBridge->aUno2Cpp ) ; 

} 

// destroy temp uno param 

uno_destructData ( pUnoArgs [nindex] , pParamTypeDescr, 
) ; 

TYPELIB_DANGER_RELEASE( pParamTypeDescr ); 
) 

II return 

if (pCppReturn) // has complex return 
( 

if (pUnoReturn != pCppReturn) // needs reconversion 

{ ' 

uno_copyAndConvertData ( pCppReturn, pUnoReturn, 

pReturnTypeDescr, &pThis->pBridge->aUno2Cpp ) ; 
// destroy temp uno return 
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uno_destructData ( pUnoReturn, pReturnTypeDescr, 0 ); 
} 

// complex return ptr is set to eax 
*(void ** )pRegisterReturn = pCppReturn; 
} 

if (pReturnTypeDescr) 
{ 

typelib_TypeClass eRet = 

(typelib^TypeClass) pReturnTypeDescr->eTypeClass; 
TYPELIB_DANGER__RELEASE( pReturnTypeDescr ); 
return eRet; 
} 

else 

return typelib_TypeClass_VOID; 

) 
} 



[0824] In Figure 10, read parameters operation 1001 reads the parameters from the stack. All simple parameters 
are directly accessed on the stack (up to eight bytes). All complex structures, e.g., interfaces, are referenced by a 
pointer. Since in this example UNO and C++ types have the same binary size (See Table 5), only interfaces need to 
be exchanged. 

[0825] Read parameters operation 1001 transfers to convert parameters operation 1002. Convert parameters oper- 
ation 1002, using the parameter type description, converts the parameters read to the UNO environment and transfers 
to allocate memory operation 1003. Allocate memory operation 1003 allocates memory for the out parameters returned 
by the call to the UNO interface, and for the return value. Allocate memory operation 1003 transfers processing to 
dispatch call operation 1004. 

[0826] Dispatch call operation 1004 calls, in this exaniple, method bar in UNO interface XExampIe. In general, dis- 
patch call operation 1004 dispatches a call to the source interface (See Fig. 4). The call is executed in the source 
environment and the results, if any, are returned to operation 1004 that in turn transfers to exception check operation 
1005. 

[0827] Exception check operation 1005 determines whether an exception was thrown in response to the call. If an 
exception was thrown, check operation 1005 transfers processing to dean up operation 1110 and othenwise processing 
transfers to convert parameters operation 1 020. 

[0828] Clean up operation 1010 cleans up any temporary parameters that were created in the call in operation 1004. 
Operation 1010 transfers to throw exception operation 1030 that in turn throvys an exception in the destination envi- 
ronment based upon the exception received from the call to the source environment 

[0829] If an exception was not thrown in the source environment, convert parameters operation 1020 converts any 
parameters that were retumed from operation 1 004, e.g., out parameters and/or inout parameters using the parameter 
type description, from the source environment to the destination environment, and transfers to clean up operation 1 02 1 . 
Clean up operation 1021 cleans up any temporary parameters that were created in the call in operation 1004 and 
transfers to convert return value operation 1 022. Operation 1 022 converts any return value from the source environment 
to the destination environment so that both the return value and any retumed parameters are written back, in this 
example to C++. Processing returns to mediate method 900 that in turn returns to fill return registers 813 in method 
vTableSIO. 

[0830] In fill retum registers operation 81 3, if the type is one of float, double, hyper, or unsigned hyper, an appropriate 
action is taken to properly All the retum registers. Otherwise, a 32-bit integer is placed in register eax. See Table 13 
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for one embodiment of operation 813. 

[0831] The above example assumed that the original call was in a C++ environment and was directed to a method 
of an interface in the UNO environment. In the embodiment of Figure 1 A. another possibility is that a call is made in 
the UNO environment, I.e.. environment 120 to a C++ method in environment 150. In this case, the bridge and proxy 

5 would be in the UNO environment. Alternatively, in Figure 1B, the intermediate environment is a UNO environment. 
[0832] In this embodiment, stmct cppu_unolnterfaceProxy in Table 9 is used to instantiate the UNO proxy that wraps 
a C++ interface. As explained more completely below, when the proxy interface is called, a check is made to determine 
if a method of the proxy interface has been called. If a method was called, any input parameters are converted using 
the type description and pushed on a processor stack, and then a call is dispatched to the demanded vtable slot in the 

10 source interface. 

[0833] After execution of the dispatch call, the retumed information is checked to detemiine whether a C++ exception 
was generated. If no exception has occun-ed, the inout/out parameters are reconverted. In this example, the reconver- 
sion of inout/out parameters is only important for values representing interfaces or values containing interfaces, be- 
cause the values of all objects in the UNO environment are binary compatible on a specific computing architecture. 
15 [0834] The UNO proxy, as defined by Table 9, holds the interface origin, i.e., the target C++ interface. Thus, the UNO 
proxy can register at with the UNO environment on the first execution of method acquire, and can revoke itself on its 
last execution of method release from its environment. 

[0835] The UNO proxy manages a reference count for the proxy, a pointer to the bridge of the UNO proxy to obtain 
the counterpart mapping, the C++ interface the UNO proxy delegates calls to, the (interface) type the UNO proxy is 
20 emulating, and an object identifier (old). The type and object identifier are needed to manage objects from environments, 
for proof of object identity, and to improve performance. A proxy to an interface is not needed if there is already a 
registered proxy for that interface. 

[0836] When the call to a method in the wrapped C++ interface is executed, the call is directed to the UNO proxy. 
Figure 11 is a process flow diagram of one embodiment of the operations performed by the UNO proxy. One example 
25 of computer code for this embodiment is presented in TABLE 16. 
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TABLE: 109.: EXAMPLE OF A METHOD dispatch USED BY A 
UNO PROXY WRAPPING A C++ INTERFACE 



void SAL_CALL cppu_unoInterf aceProxy_dispatch ( 
uno_Interface * pUnoI, const 

typelib_TypeDescription * pMemberDescr, void * 
pReturn, void * pArgs [) / uno_Any ** ppException ) 

{ 

// is my surrogate 

cppu_unoInterfaceProxy * pThis = static_cast< 

cppu_unoInterfaceProxy * >( pUnoI ); 
typelib_Interf aceTypeOescription * pTypeDescr = pThis- 

>pTypeDescr; 

switch (pMemberDescr->eTypeClass) 
{ 

case typelib_TypeClass_INTERFACE_ATTRIBUTE : 
{ 

// determine vtable call index 
sal_Int32 nMemberPos = 

{ (typelib_InterfaceMemberTypeDescription 

* ) pMemberDescr) ->nPosition; 
OSL_ENSHURE( nMemberPos < pTypeDescr->nAllMembers, "### 

member pos out of range!" ); 
sal_Int32 nVtableCall = pTypeDescr- 

>pMapMemberIndexToFunctionIndex [nMemberPos] ; 
OSL_ENSHaRE( nVtableCall < pTypeDescr- 

>nMapFunctionIndexToMemberIndex, "### illegal 

vtable index! " ) ; 
typelib_TypeDescriptionReference * pRuntimeExcRef = 0; 
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if (pReturn) 

{ ' . . 

// dependent dispatch 
cpp_call( pThis, nVtableCall, 

( (typelib_InterfaceAttributeTypeDescription 

*•) pMemberDescr) ->pAttributeTypeRef , 

0, 0, // no params 

1, &pRuntimeExcRef , // RuntimeException 
pReturn, pArgs, ppException ) ; 

} 

else 

{ 

// is SET 

typelib_MethodParaineter aParam; 
aParam.pTypeRef = 

{ (typelib_InterfaceAttributeTypeDescription 

*) pMerT±>erDescr) ->pAttributeTypeRef ; 
aParam.bin = sal_True; 

aParam.bOut = sal_False; 

typelib_TypeDescriptionReference * pReturnTypeRef = 0; 
oust ring aVoidName ( RTL_CONSTASCII_USTRINGPARAM ( "void" ) 
) ; 

Typelib_typedescriptionreference_new {^pReturnTypeRef , 
typelib_TypeClass_VOID, aVoidName .pData ); 

// dependent dispatch 

cpp_call( pThis, nVtableCall +1, // get, then set ' 
method 

pReturnTypeRef, 
1, saParam, 
1, &pRuntimeExcRef , 
pReturn, pArgs, ppException ); 
typelib_typedescriptionreference_release ( 
pReturnTypeRef ) ; 
} 

break; 
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} 

case typelib_TypeClass_INTERFACE_METHOD: 
{ 

// determine vtable call index 
sal_Int32 nMemberPos = 

( (typelib_InterfaceMemberTypeDescription 

* ) pMemberDescr ) ->nPosition; 
OSL_ENSHURE( nMemberPos < pTypeDescr->nAllMembers, 

member pos out of range!" )/ 
sal_Int32 nVtableCall = pTypeDescr- 

>pMapMemberIndexToFunctionIndex [nMemberPos] ; 
OSL_ENSHURE( nVtableCall < pTypeDescr- 

>nMapFunctionIndexToMember Index, "### illegal 

vtable index ! " ) ; 
switch (nVtableCall) 
{ 

// standard calls 

case 1: // acquire uno interface 
(*pUnoI->acquire) ( pUnoI ); 
*ppException = 0; 
break; 

case 2: // release uno interface 

{*pUnoI->release) ( pUnoI ); 

*ppException = 0; 

breaks- 
case 0: // querylnterface ( ) opt 
{ 

typelib_TypeDescription * pTD = 0; 

TyPELIB_DANGER_GET ( &pTD, reinterpret_cast< Type * >( 
pArgs[0] ) ->getTypeLibType ( ) ); 

OSL_ASSERT( pTD ) ; 

uno_Interf ace * pinterface = 0; 

( *pThis->pBridge^>pUnoEnv- 

>getRegisteredInterface) (pThis->pBridge->pUnoEnv, 
(void **) &plnterf ace, pThis->oid.pData, 
(typelib_InterfaceTypeDescription *)pTD ); 
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if (pinterface) 

{ 

uno_any_construct { reinterpret_cast< uno_Any * > ( 

pReturn ), &plnterface^ pTD, 0 ); 
(*plnterface->release) ( pinterface ) ; 
TYPELIB_DANGER_RELEASE( pTD ); 
*ppException = 0; 
break; 

} 

TYPELIB_DANGER__RELEASE( pTD ); 

} // else perform querylnterface ( ) 

default: 

// dependent dispatch 
cpp_cail( pThis, nVtableCall, 

( (typelib_InterfaceMethodTypeDescription 

* ) pMemberDescr ) ->pReturnTypeRef , 

( {typelib__InterfaceMethodTypeDescription 

*) pMemberDescr) ->nParams, 

( (typelib_InterfaceMethodTypeDescription 

*) pMemberDescr) ->pParams, 

( (typelib_InterfaceMethodTypeDescription 

* ) pMemberDescr) ->nExceptions, 

( (typelib_InterfaceMethodTypeDescription 

*) pMemberDescr) ->ppExceptions, pReturn, pArgs, 

ppException ) ; 
) 

break; 
} 

default: 
( 

: :com: :sun: ;star: :uno: : Runt imeExcept ion aExc (OUString ( 
RTL_CONSTASCII_USTRINGPARAM( "illegal member type 
description ! " ) ) , pThis->pCppI ) ; 

typelib_TypeDescription * pTD = 0; 

const Type & rExcType = : : getCppuType ( {const 

:: com: : sun: : star :: uno: :RuntimeExcept ion *)0 ); 
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TYPELIB_DANGER_GET ( &pTD, 

rExcType . getTypeLibType ( ) ) ; 

uno_any_construct ( *ppException, &aExc, pTD, 

0 ); 

TYPELIB_DANGER_RELEASE( pTD ); 
} 
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[0837] Method call check 1101 of method dispatch 1 100 determines whether the call is a method call. If the call is a 
method call processing transfers to acquire/release check operation 1110, and otherwise to attribute get check oper- 
ation 1120. 

[0838] Acquire/release check operation 1110 branches to acquire/release call operation 1111 if the method call is a 
call to either method acquire or method release, because these calls can be executed without calling the interface in 
the second environment. If the method call is not a call to either method acquire or method release, processing transfers 
from check operation 1110 to query interface check operation 1112. Acquire/Release call operation 1111 performs the 
appropriate method, which is a non-virtual call, and returns. 

[0839] Query interface check operation 1112 determines whether the method call is to method querylnterface. If the 
method call is not to method querylnterface, check operation 1112 transfers to call Env2_to_Env1 with Interface oper- 
ation 1130 and otherwise transfers to registered interface available check operation 1113. 

[0840] If there is a registered interface in the source environment for method querylnterface, check operation 1113 
transfers to set retum value operation 1114 and otherwise to call Env2_to_Env1 with Interface operation 1130. Set 
return value operation 1114 sets the registered interface as the return value and returns. 

[0841] If . the call to the C++ proxy was not a method call, check operation 1101 transfers to attribute get check 
operation 1120. In this embodiment, there is either an attribute get or an attribute set. If the call to the UNO proxy is 
an attribute get, check operation 1120 transfers to prepare attribute get call operation 1121 and otherwise transfers to 
prepare attribute set call operation 1122. Both operations 1121 and 1 122 set up the parameters for the call and transfer 
to call Env2_to_Env1 with Interface operation 1130. The call is given the C++ interface pointer, a vtable index, and all 
parameters necessary to perform the C++ virtual function call. 

[0842] An embodiment of method Env2_to_Env1 with interface for the UNO proxy is presented in Table 17. Figure 
12 is a process flow diagram for one embodiment of method Env2_to_Env1 with interface. 
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TABLE 110.: EXAMPLE of METHOD Env2_to_Envl with 
interface FOR THE UKO PROXY 



namespace CPPU_CURRENT_NAMESPACE 
{ 

inline static void cpp_call (cppu_unoInterf aceProxy * 
pThis, sal_Int32 nVtableCall, 

typelib_TypeDescriptionReference * pReturnTypeRef , 
sal_Int32 nParams, typelib_MethodParameter * 
pParams, sal_Int32 nExceptions/ 
typelib^TypeDescriptionReference ** 
ppExceptionRef s, void * pUnoReturn, void * 
pUnoArgsd, uno_Any ** ppCJnoExc ) 

( 

//max space for: [complex ret ptr] , values Iptr 

char * pCppStack = (char *)alloca( sizeof (sal_Int32) + 

. (nParams * sizeof (sai_Int 64 ) ) ); 
char * pCppStackStart = pCppStack; 
// return 

typelib_TypeDescription * pReturnTypeDescr = 0; 
TYPELIB_DANGER_GET ( &pReturnTypeDescr, pReturnTypeRef 
) ; 

OSL_ENSHURE( pReturnTypeDescr, "### expected return 

type description!" ); 
//if != 0 && != pUnoReturn, needs reconversion 
void * pCppReturn = 0; 
i f ( pRe t urnTypeDe scr ) 
'( 

if (cppu_isSimpleType ( pReturnTypeDescr )) 

{ 

pCppReturn = pUnoReturn; // direct way for simple types 
} 

else 
{ 
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// complex return via ptr 
// direct way 

pCppReturn =.*{voici **)pCppStack = 

(cppu_relatesToInterface ( pReturnTypeDescr ) ? 

alloca( pReturnTypeDescr->nSize ) : pUnoReturn); 
pCppStack += sizeof(void *); 
} 
} 

// stack space 

OSL_ENSHURE( sizeof(void *) sizeof (sal_Int32) , "### 

unexpected size!" ); 
// args 

void pCppArgs = (void **)alloca( 3 * sizeof{void *) 
* nParams ) ; 

// indices of values thats have to be converted 
// (interface conversion cpp<=>uno) 
sal_Int32 pTempIndizes = (sal__Int32 *) (pCppArgs + 
nParams) ; 

// type descriptions for reconversions 
typelib_TypeDescription ** ppTempParamTypeDescr = 

(typelib_TypeDescription **) (pCppArgs + (2 * 

nParams) ) ; 
sal_Tnt32 nTempIndizes = 0; 

for ( sal_Int32 nPos = 0; nPos < nParams; ++nPos ) 
{ 

const typelib_MethodParameter & rParam = pParams [nPos] ; 
typelib_TypeDescription * pParamTypeDescr = 0; 
TYPELIB_DANGER_GET ( &pParamTypeDescr, rParam. pTypeRef 
) ; 

if ( !rParam.bOut cppu_isSimpleType { pParamTypeDescr 
)) 

{ 

uno_copyAndConvertData { pCppArgs [nPos] = pCppStack, 

pUnoArgs [nPos] , pParamTypeDescr, &pThis->pBridge- 
>aUno2Cpp ) ; 

switch (pParamTypeDescr->eTypeClass) 
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{ 

case typelib_TypeClass_HYPER: 

case typelib_TypeClass_UNSIGNED_HYPER: 

case typelib_TypeClass_DOUBLE: 

pCppStack += sizeof (sal_rnt32) ; // extra long 

//no longer needed 

TyPELIB_DANGER_RELEASE( pParamTypeDescr ); 
} 

else // ptr to complex value I ref 
{ 

if (! rParam.bin) // is pure out 
{ 

// cpp out is constructed mem, uno out is not! 
uno_constructData ( *(void **)pCppStack = 

pCppArgs [nPos] = alloca ( pParamTypeDescr->nSize ), 

pParamTypeDescr ) ; 
pTempIndizes [nTempIndizes] = nPos; 
// default constructed for cpp call 
// will be released at reconversion 

ppTempParamTypeDescr (nTempIndizes++] = pParamTypeDescr; 
} 

// is in/inout 

else if (cppu_relatesToInterface ( pParamTypeDescr )) 
{ 

uno_copyAndConvertData ( *(void **)pCppStack - 

pCppArgs [nPos] = alloca ( pParamTypeDescr->nSize ), 
pUnoArgs [nPos] , pParamTypeDescr, &pThis->pBridge- 
>aUno2Cpp ) ; 

pTempIndizes [nTempIndizes] = nPos; 

// has to be reconverted 

// will be released at reconversion 

ppTempParamTypeDescr (nTempIndizes++ ] = pParamTypeDescr; 
) 

else // direct way 
{ 
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*{void **)pCppStack = pCppArgs [nPos] = pUnoArgs [nPos ] ; 
// no longer needed 

TyPELIB_DANGER_RELEASE( pParamTypeDescr ); 

} 
} 

pCppStack += sizeof {sal_Int32) ; // standard parameter 
length 

} 

// only try-finally/ try-except statements possible... 

try 

{ 

try 

{ 

// pCppI is msci this pointer 

callVirtualMethod ( pThis->pCppI , nVtableCall , 
pCppReturn, pReturnTypeDescr->eTypeClass , 
(sai_Int32 *) pCppStackStart, (pCppStack - 
pCppStackStart) / sizeof (sal_Int32) ); 

//NO exception occured. . . 

*ppUnoExc = 0; 

// reconvert temporary params 
while {nTempIndizes — ) 

{ 

sal_Int32 nindex = pTempIndizes [nTempIndizes] ; 
typelib_TypeDescription * pParamTypeDescr = 

ppTempParamTypeDescr [nTempIndizes] ; 
if (pParams [nindex] .bin) 
{ 

if (pParams [nindex] .bOut) // inout 
{ 

uno_destructData ( pUnoArgs [nindex] , pParamTypeDescr, 0 

) ; // destroy uno value 
uno_copyAndConvertData ( pUnoArgs [nindex] , 

pCppArgs [nindex] , pParamTypeDescr, &pThis- 

>pBridge->aCpp2tIno ) ; 

) 
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} 

else // pure out 
{ 

uno__copyAnciCon vert Data ( pUnoArgs [nindex] , 

pCppArgs [nindex] , pParamTypeDescr, &pThis- 
>pBridge->aCpp2Uno ) ; 

} 

// destroy temp cpp param => cpp: every param was 
// constructed 

uno__destructData ( pCppArgs [nindex] , pParamTypeDescr, 

cpp_reiease ) ; 
TyPELIB_DANGER_RELEASE( pParamTypeDescr ); 
) 

// return value 

if (pCppReturn && pUnoReturn != pCppReturn) 

{. 

uno_copyAndConvertData ( pUnoReturn, pCppReturn, 

pReturnTypeDescr, 
&pThis->pBridge->aCpp2Uno ) ; 

urio_destructData ( pCppReturn, pReturnTypeDescr, 
cpp_release ) ; 

) 
) 

except (msci__f ilterCppException ( 

GetExceptionInf ormation ( ) , *ppUnoExc, &pThis- 
>pBridge->aCpp2Uno ) ) 

{ 

// *ppUnoExc is untouched and any was constructed by 

// filter function finally block will be called 

return; 

} 
} 

finally 

( 

// cleanup of params was already done in reconversion 
// loop if no exception occured; this is quicker than 
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// getting all param descriptions twice! so cleanup 
// only if an exception occured: 
if (*ppUnoExc) 
{ 

// temporary params 
while (nTempIndizes — ) 

{ ■ ■ 

sal_Int32 nindex = pTempIndizes [nTempIndizes] ; 
// destroy temp cpp param => cpp: every param was 
// constructed 

uno_destructData ( pCppArgs [nindex] , 

ppTempParamTypeDescr [nTempIndizes] , cpp_release ) ; 
TYPELIB_DANGER_RELEASE ( 

ppTempParamTypeDescr [nTempIndizes] ); 

} 
} 

// return type 

if (pReturnTypeDescr ) 

TYPELIB_DANGER_RELEASE { pReturnTypeDescr ); 
) 
) 
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[0843] In Figure 12, read parameters operation 1201 reads the parameters from the call. Read parameters 
operation 1201 transfers to convert parameters 

operation 1202. Convert parameters operation 1202 converts the parameters read to the C++ environment. A C++ call 
stack is built in memory. All simple types, up to eight bytes are put directly on the stack, and all othertypes are referenced 
by a pointer. 

Operation 1202 transfers to allocate memory 

operation 1203. Allocate memory operation 1203 allocates memory for the out parameters returned by the call to the 
C++ interface, and for the return value. 

[0844] Allocate memory operation 1203 transfers processing to dispatch call operation 1204. 
[0845] Dispatch call operation 1204 performs a C++ virtual call on the C++ interface. In one embodiment, method 
call Virtual, an assembly function performing the specific virtual call having the right registers set (See Table 18), is 
called and passed an array that is the call stack. The call is executed in the C++ environment and the results, if any, 
are returned to operation 1204 that in turn transfers to exception check operation 1205. 

[0846] Exception check operation 1205 determines whether an exception was thrown in response to the call. If an 
exception was thrown, check operation 1205 transfers processing to convert exception operation 1210 and otherwise 
processing transfers to set exception operation 1220. 

[0847] Convert exception operation 1210 converts the C++ exception to the UNO environment, and sets an exception 
out any with the converted exception. Operation 1210 transfers to clean up operation 1211 that in turn cleans up any 
temporary parameters that were created in the call in operation 1204 and transfers to return to operation 1130. 
[0848] If an exception was not thrown in the source environment, set exception operation 1220 sets the exception 
out any to zero, and transfers to convert parameters operation 1221. 
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[0849] Convert parameters operation 1221 converts any parameters that were returned from operation 1204. e.g.. 
out parameters and/or inout parameters, from the source environment i.e., the C++ environment, to the destination 
environment, i.e., the UNO environment Operation 1221 also cleans up any temporary parameters that were created 
in the call in operation 1204 and transfers to convert return value operation 1222. Operation 1222 converts any return 
value from the source environment to the destination environment so that both the return value and any rBtumed 
parameters are written back, in this example to the UNO caller. 

TABLE 111.: AN EXAMPLE OF A METHOD callVirtualMethod 
THAT IS USED BY THE UNO PROXY TO DISPATCH A CALL TO THE 
INTERFACE IN THE C++ ENVIRONMENT 



inline static void callVirtualMethod ( void * 
pThis, sal_Int32 nVtablelndex, void * pRegisterReturn, 
typelib_TypeClass eReturnTypeClass, sal_Int32 * 
pStackLongs, sal_Int32 nStackLongs ) 

{ 

// parameter list is mixed list of * and values 

// reference parameters are pointers 

OSL_ENSHURE( pStackLongs pThis, "### null ptr!" 

) ; 

OSL_ENSHURE( (si2eof(void *) ==4) && 
(sizeof (sal_Int32) ==4), "### unexpected size of int!" 
) ; 

asm 

{ 

mov eax, nStackLongs 

test eax, eax 

je Lcall 
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// copy values 

mov ecx, eax 

shl eax, 2 // sizeof (sal_Int32) 

4 

add eax, pStackLongs // params stack 

space 

Lcopy: sub eax, 4 

push dword ptr (eax] 

dec ecx 

jne Lcopy 
Lcall: 
// call 

mov ecx, pThis 

push ecx // this ptr 

mov edx, [ecx] // pvft 

mov eax, nVtablelndex 

shl eax, 2 // sizeof (void *) 

== 4 

add edx, eax 

call [edx] //interface method call must be 
cdecl! 

// register return 

mov ecx, eReturnTypeClass 

cmp ecx, typelib_TypeClass__VOID 

je Lcleanup 

mov ebx, pRegisterReturn 



// int32 



// int8 



cmp ecx, typelib_TypeClass__LONG 

je Lint32 

cmp ecx, typelib_TypeClass_UNSIGNED_LONG 

je Lint32 

cmp .ecx, typelib_TypeClass_ENUM 

je Lint32 

cmp ecx, typelib_TypeClass_BOOLEAN 

je Lints 
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cmp ecx, typelib_TypeClass_BYTE 

je Lints 

// intl6 

cmp ecx, typelib_TypeClass_CHAR 

je Lintl6 

cmp ecx, typelib_TypeClass_SHORT 

je Lintl6 

cmp ecx, typelib_TypeClass_UNSIGNED_SHORT 

je Lintl6 

// float 

cmp ecx, typelib_TypeClass_FLOAT 

je Lfloat 

// double 

cmp ecx, typelib_TypeClass_DOUBLE 

je Ldouble 

// int64 

cmp ecx, typelib_TypeClass_HYPER 

je Lint64 

cmp ecx, typelib_TypeClass__UNSIGNED_HyPER 

je Lint64 

jmp Lcleanup // no simple type 
Lints : 

mov byte ptr [ebx] , al 

jmp Lcleanup 
Lintl6: 

mov word ptr [ebx], ax 

jmp Lcleanup 
Lfloat: 

fstp dword ptr [ebx] 

jmp Lcleanup 
Ldouble: 

fstp qword ptr [ebx] 

jmp Lcleanup 
Lint64: 

mov dword ptr [ebx], eax 

mov dword ptr [ebx+4], edx 
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jmp Lcleanup 
Lint32: 

mov dword ptr [ebx] , eax 

jmp Lcleanup 
Lcleanup: 

// cleanup stack (obsolete though because of 
function) 

mov 
shl 
add 
add 

} 

} - 



[0850] In the above description of the example, various methods were described and discussed. Figure 13A to 24 
are specific examples of one embodiment of such methods. In particular, in Figs 13A and 13B. an embodiment of 
mapping an interface from the UNO environment to the C++ environment Is presented. See Figure 4. 
[0851] Fig. 14 is an example of a method free and a method for revoking the proxy. Method free Is called indirectly 
by the C++ proxy described above when the reference count goes to zero and the C++ proxy should be deleted. Fig. 
15 includes an example of a C++ proxy that includes a method acquireProxy; an example of a method releaseProxy 
that is used to revoke the C++ proxy from the C++ environment structure; and a method ccpu_cpplnterfaceProxy to 
instantiate, acquire and register the C++ proxy 

[0852] Figs. ISA and 16B include an example of a method free that is called indirectly by the UNO proxy described 
above when the reference count goes to zero and the UNO proxy should be deleted; an example of a method acquire 
that is used in acquiring the UNO proxy; and an example of a method release that is used to revoke the UNO proxy 
[0853] In Figs 17A and 17B, an emtKxJiment of a method Mapping for mapping from the C++ environment to the 
UNO environment is presented. Figure 18 includes is a C++ implementation of the UNO proxy that includes a con- 
structor cpu.unolnterfaceProxy to instantiate, acquire and register the UNO proxy; a method for acquiring a mapping 
and a method for releasing a mapping. 

[0854] Figure 1 9 illustrates constructors for a mapping and a bridge; and a method for freeing a bridge. Figure 20 is 
an embodiment of methods for acquiring and releasing a bridge. Figure 21 includes a method cppu_ext_getMapping 
to create a mapping between two specified environments. Figure 22 is an embodiment of a method to create the static 
part of an object Id. The object id contains two parts, an object specific part and a static part. Figure 23 is an embodiment 
of a method to create a complete object Id, containing both, the object specific and the static parts. Figure 24 includes 
a method for acquiring a C++-urK) environment; a method for releasing a C++-uno environment; and a method to 
initialize a C++-uno environment. 

[0855] In the following, further embodiments of the invention will be described with respect to Figs. 25 - 38. 
[0856] First, reference is made to Fig. 25. A first software program 251 , created with any convenient programming 
language, for example C++, and compiled with a certain compiler for C++, uses a first binary specification. This first 
binary- specification depends on both, the programming language and on the compiler The first software program 251 
may be, for example, able to present numbers in graphical form. In order to calculate the exact dimensions of the 
graphs the first software program 251 may want to employ a second software program 252, created with another 
programming language, for example Java, and compiled by using a certain compiler for Java. This second software 
program 252 uses the second binary specification for communication. 

[0857] The use of the second software program 252 by the first software program 251 requires its initialization, for 
example, by calling a loader function 255. The second software program 252 may then initialize its sut>-program 252a 
for creating the stub 254. The subrprogram 252a must consider the limited functionality in order to arrive at the desired 
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stub 254, namely a mcxiule for transforming commands and responses relating to the requested limited functionality. 
Based on this limited functionality, the sut>-program 252a selects the relevant mappings of the bridge 257 between the 
second binary specification and the intenmediate binary specification. 

[0858] The first software program 251 may correspondingly initiate a sub-program 251a to create the proxy 253 in 
5 a simitar way, by employing the bridge 256 between the first binary specification and the intermediate binary specifi- 
cation. This sut>-program 251a may be Informed about the limited functionality from the first software program 251. 
However, It may also know this limited functionality from the second software program 252 by communicating via the 
communication channel 258. This channel 256 may t>e any suitable real or virtual connection which allows the transfer 
of data. 

10 [0859] After the stub 254 and proxy 253 have been created they are arranged so as to allow the communication 
between the first softA^are program 251 and the second software program 252. Once this arrangement is effected the 
first software program 251 sends the command to be transfomied to the proxy 253. The proxy 253 may transform this 
command from the first binary specification into the intermediate binary specification. This intermediate binary speci- 
fication corresponds, for example, to the binary UNO specification. The proxy 253 may transmit this command in the 

15 intermediate binary specification to the stub 254. The stub 254 may transform the command from the intermediate 
binary specification into the second binary specification and may transmit the command ttien to the second software 
program 252. 

[0860] The second software program 252 may execute the command, for example, the command to calculate the 
dimensions of a graph and may generate a response for the first software program 251 , This response may be trans- 
20 formed and transmitted by the stub 254 and the proxy 253 from tiie second software program 252 to the first software 
program 251. 

[0861] The an^ows shown in Fig, 25 between the first software program 251 , the proxy 253, the stub 254, the second 
software program 252 and the loader function 255 show the possible routes of communication. The arrows between 
the proxy 253 and the bridge 256 and between the stub 254 and the bridge 257 represent the contribution of tiie bridges 

25 256 and 257 to the creation of the proxy 253 and the stub 254, respectively 

[0862] Fig. 26 represents an example for the initial communication of a first software program 251 and a second 
software program 252. The initial communication between the two software programs 251 , 252 is earned out, before 
the creation of tiie stub 254 and of the proxy 253 is initiated. Due to the different binary specifications used by tiie two 
software programs 251 , 252, namely the first and tine second binary specification, this initial communication will regularly 

30 be extremely limited. It may be effected as explained exemplary in the following. 

[0863] In a first step 2600 the first software program 251 may call a loader function 255 for the second software 
program 252. The loader function 255 may be any known joader function for ttiis second software program 252. A 
loader function ifor a program is a software module which "^vakes up" this program so that it carries out certain functions. 
Herein, the loader function may be addressed in one binary specification and may wake up a program using a different 

35 binary specification. However, the loader function is not suited to provide any detailed communication between pro- 
grams using different binary specifications. 

[0864] The loader function 255 may be used by the first software program 251 from the beginning. This is the case, 
if the first software program 251 knows or assumes that the second software program 252 does not use the same 
binary specification as itself, namely the first binary specification. If this knowledge is not present in the first software 
40 program 251, it may simply try to call the second software program assuming that it will understand the first binary 
specification. In this case, the first software program 251 may only employ the loader function 255 if the direct com- 
munication with the second software program 252 fails and a corresponding message is returned to the first software 
program 251. 

[0865] In the calling step 2600 the first software prx>gram 251 informs the loader function 255 about the limited func- 
45 tionality requested from the second software program 252. Therefore, the loader function 255 must be suited to receive 
and cany this information. In order to provide this information to the loader function 255 the first software program 251 
may hand over to the loader function 255 the command to be carried out by the second software program 252, so that 
the second software program 252 may, on receipt of the call of the loader function 255 decide itself which functionality 
isneeded, or the first software program 251 may provide the loader function 255 directly with the description of a limited 
50 functionality of the second software program 252 which will be required by the first software program 251 . 

[0866] In step 2601 the loader function 255 contacts and initializes a reception function of the second software pro- 
gram 252 to be able to ti^nsmit in the next step 2602 its information about the limited functionality required from the 
second software program 25.2. In the next step 2603 the second software program 252 analyses the information re- 
ceived from the loader function 255 regarding the required limited functionality. After the analysis of the limited func- 
55 tionality required the second software program 252 initializes the creation of a stub 254. 

[0867] Fig. 27 shows the creation of a stub 254. The stub 254 has the task to fa-ansform commands sent by first 
software program 251 to the second software program 252 from the intermediate binary specification into the second 
binary specification used by the second software program 252 and to transform responses sent by the second software 
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program 252 back to the first software program 251 from the second binary specification into the intermediate binary 
specification. Furthermore, the stub 254 may be assigned the task to transmit the transformed commands or responses 
to the recipients, the second software program 252 or the proxy 253. respectively. 

[0868] in step 2700 the second software program 252 may initialize a sub-program 252a for creating the stub 254. 
This sub-program 252a may be an integral part of the second software program 252 or it may be as wet! a separate 
independent software module which can be used by this and potentially any other second software program 252, 
Accordingly, the sub-program 252a may be stored on the computer system or storage device on which the second 
software program 252 is stored. However, the sut}-program 252a may also be stored on another computer system or 
storage device to which the second software program 252 has access. 

[0869] In step 2701 the sut>-program 252a receives from the second software program 252 a description of the limited 
functionality required from the second software program 252. Then, in step 2702 the bridge 257 between the second 
binary specification used by the second software program 252 and the intermediate binary specification is contacted. 
This bridge 257 provides a mapping of at least all basic commands between the mentioned two binary specifications. 
It may be stored at any place accessible for the sub-program 252a. In many cases there may exist a library with bridges 
for a number of second binary specifications, assuming that the intermediate binary specification used would be the 
same for all intended operations. 

[0870] Frorri the selected bridge 257 the sub-program 252a chooses in step 2703 the mappings necessary to use 
the required limited functionality of the second software program 252. This means all transformations, but not more 
than these, rnust be selected which are required to transform commands and responses which could arise when using 
the relevant functionality. Finally, in step 2704 the sub-program 252a creates the stub 254 based on the chosen map- 
pings. 

[0871] Fig. 28 represents in the form of a flow chart the creation of the proxy 253. The proxy 253 has the task to 
transform commands and responses between the first binary specification and the intermediate binary specification. 
It is insofar similar to the stub 254 which has, as it was described above, the task to render these transformations 
between the second binary specification and the intermediate binary specification. 

[0872] In step 2800 the first software program 251 may initialize a sub-program 251a for creating the proxy 253. This 
sul>program may be an integral part of the first software program 251 , but may as well be separate and independent 
from it. The sub-program 251a may be accessible for a larger number of first software programs 251, In step 2801 the 
sub-program 251a receives from the first software pnDgram 251 information regarding the limited functionality required 
from the second software program 252. This information may be provided by passing on the actual command the first 
software program 251 plans to send to the second software program 252, so that the sub-program 251a may derive 
from this command the information about the limited functionality, or the first software program 251 may provide the 
sub-program 251a with a description of the limited fijnctionality. 

[0873] In an alternative embodiment the description of the limited functionality may be received from the sub-program 
252a for creating the stub 254. The sub-program 252a has the required description, because it has to create the stub 
254 according to the same description. The description may be exchanged t>etween the sub-program 252a and the 
sub-program 251a by any suitable means of communication. 

[0874] In yet an alternative embodiment the description of the limited functionality of the second software program 
252 may be derived directly by mapping the stub 254 into the first binary specification, in order to create a proxy. This 
is possible, because the stub 254 reflects the required limited functionality in listings between the second binary spec- 
ification and the intermediate binary specification which are necessary for the transfomnation of commands and re- 
sponses. Therefore, the intermediate binary specification side of the listings of the stub 254 may be taken as the starting 
point for the creation of the proxy 253, which is completed by adding the corresponding parts of the listing in the first 
binary specification, as will be explained below. 

[0875] In step 2802 the sub-program 251a contacts the bridge 256, which provides a mapping of basic commands 
of the first binary specification and the intemnediate binary specification, and builds, in step 2803, the desired proxy 253. 
[0876] The proxy 253 and stub 254 are then an-anged to allow the desired communication between the first software 
program 251 and the second software program 252, as it will be described in the following along the flow chart of Fig, 
29. The an^ngement of proxy 253 and stub 254 requires that the path of exchanging transfomied commands and 
responses between the proxy 253 and the stub 254 is defined, 

[0877] Therefore, in step 2900 the second software program 252 informs the first software program 251 about the 
address information necessary to contact the stub 254 via the communication line 258. The communication line 258 
may consist of a simple data line for transmitting binary address information which can be understood from the first 
software program 251 without being able to use the second binary specification in which the second software program 
252 communicates. 

[0878] The first software program 251 provides, in step 2901, the sub-program 251a with this received address 
information, which, in step 2902, is passed on to the proxy 253. The proxy 253 then contacts, for the first time in step 
2903, the stub 254, the address of which is now known. In step 2903 the proxy 253 will also transmit its own address 
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information to the stub 254. thereby allowing the stub 254 to contact the proxy 253. Herewith, the proxy 253 and the 
stub 254 are arranged for communication, that means they can send and receive commands and responses to com- 
mands. This arranging step is also refen-ed to as binding. 

[0879] Fig. 30 shows a computer system 300 which may be used in the scope of the present invention. The computer 
5 system 300 comprises an i-/o-interface 301. a central processing unit (CPU) 302 and memory 303. It is connected to 
an external memory 304 on which mass data may be stored as well as software programs. Furthemnore, the computer 
system 300 is connected via the i-/o-interface 301 to an output device 305, for example, a screen, and to an input 
device 306, for example, a keyboard. 

[0880] The inventive method may be applied in the shown standard computer system. The first software program 
10 251 and the second software program 252 may be stored in the internal memory 303 of the computer system 300, as 
well as on its external memory 304. It is also possible that one of the programs is stored on the internal memory 303 
and the other is stored on the external memory 304. The proxy 253 and the stub 254 may be created by means of the 
CPU 302. 

[0881 1 The method according to the present invention may also be implemented and used on more than one computer 
15 system, for example, in a network or in a client-server system, as it is shown exemplary in Fig. 31 . 

[0882] Fig. 31 shows a client 310 which is connected to a server 311. This connection may be a data line 312, 
including any kind of permanent or temporary network, like, for example, the internet It is understood that, instead of 
only one client, there may be a large number of clients connected to the server. In the scope of the present invention 
the first software program 251 may, for example, be stored on client 310, while the second software program 252 may 
20 be stored on server 311 . The exchange of commands and responses may be effected via data line 312. For example, 
the bridges 256 and 257, as well as any other potentially needed bridges may be stored in one or more libraries on 
the server 31 1 . The sub-programs 251a and 252a may also be stored on the server 311 . In case the sub-program 251a 
is needed the client 310 may request from the server 311 its transmission via data channel 312. 
[0883] It is understood that the present invention may also be implemented in a variety of embodiments. In the 
25 following one embodiment of the present invention is described in more detail along Figures 32 to 35 and Tables 1 and 2. 

Creation of stub and proxy: 

[0884] In response to a call of a first software program a proxy and a stub will be created in the so-called proxy 
30 factory and the stub factory, respectively. In order to create a proxy and a stub three tasks have to be carried out. First, 
the first software program using the first binary specification has to be enabled to communicate with to the second 
software program using the second binary specification. Second, the stub factory has to create a uno_interface imple- 
mentation considering the second binary specification based on the limited functionality which delivers ail calls directed 
to the second software program to this second software program. This uno_interface is program code which is defined 
35 for the limited functionality. For the generation of the uno_interface implementation the stub factory employs information 
In the form of a type description. This uno_interface implementation is also referred to as the stub. Third, the proxy 
factory has to create a uno_interface implementation for the first binary specification. The proxy factory generates Its 
uno_interface implementation based on the infomiation of the type description. This uno_interface implementation is 
referred to as the proxy 

40 [0885] The knowledge of the type description is necessary to create the stub and the proxy, as described. This type 
description is the full description of the limited functionality, also called interface. It contains the information about the 
required limited functionality of the second software program which shalj be used by the first software program. The 
type description may refer to different types shown in Table 1. 

45 Table 1: 



Type 


UNO 


C++ 


Java 


Byte 


Signed 8 Bit 


Signed 8 Bit 


Signed 8 Bit 


Short 


Signed 16 Bit 


Signed 16 Bit 


Signed 16 Bit 


Ushort 


Unsigned 16 Bit 


Unsigned 16 Bit 


Signed 16 Bit 


Long 


Signed 32 Bit 


Signed 32 Bit 


Signed 32 Bit 


Ulong 


Unsigned 32 Bit 


Unsigned 32 Bit 


Signed 32 Bit 


Hyper 


Signed 64 Bit 


Signed 64 Bit 


Signed 64 Bit 


Uhyper 


Unsigned 64 Bit 


Unsigned 64 Bit 


Signed 64 Bit 
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Table 1: (continued) 





Type 


UNO 


C++ 


Java 


5 


Float 


Processor dependent: Intel. 
Sparc = IEEE float 


Processor dependent: Intel, 
Sparc = IEEE float 


IEEE float 




Double 


Processor dependent: Intel, 
Sparc = IEEE double 


Processor dependent: Intel, 
Sparc = IEEE double 


IEEE double 


10 


Enum 


The size of an machine word. 
Normally this is the size of an 
integer. 


The size of an machine word. 
Normally this is the size of an 
integer. 


All enum values of one enum 
declaration are static object of a 
class. Each object contains a 32 
bit value which represents the 
enumeration value. 


15 


Boolean 


1 Byte- 


1 Byte. 


Boolean 


Char 


16 Biton WNT, W95, W98. Os2. 
32 Bit on Unix 


16 Bit on WNT, W95. W98. Os2. 
32 Bit on Unix 


Unsigned 16 bit (char) 


20 
25 


String 


A pointer to a structure which 
have the following members: 
long refCount; 

long length, wchar_t buffer[..]: 
The string in buffer is 0 
temiinated This is the 
rtl.wString structure in the rtl- 
library 


A pointer to a structure which 
have the 

following members: long 
refCount; 

long length; wchar_t buffer[..,J; 
The string In buffer Is 0 
terminated. This is the 
rtLwString stmcture in the rtl- 
library 


java.lang.String" 


30 
35 


Stnjcture 


The structure contains the 
members in 

the order of the declaration. 
The 

memory layout is described at 
the 

beginning of this chapter. 


The structure contains the 

members In the 

order of the declaration. The 

memory 

layout is described at the 
beginning of this 

chapter. 


A class which is derived from 

java.lang.Objecr and contains 
members in the specified order. 


40 
45 


Union 


The size Is 4 + size of the 
largest type. In front of the 
union members are a 

long value (nSelect) which 
describes 

the position of the valid 
member (0 is 
the first). 


The size is 4 + size of the largest 
type. In 

front of the union members are 
a long value (nSelect) which 
describe the position 

of the valid member (0 is the 
first). 


Not specified yet 


50 




A pointer to a structure which 
has the 

following members: 
void pElements; 


A pointer to a structure which 
has the 

following members: 
void* pElements; 




55 


Sequence 


long nElements. 

long nRefCount; 

The pElements are a memory 

area that 


long nElements; 

long nRefCount; 

The pElements are a memory 

area that 


It is a normal Java array. 
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Table 1: (continued) 



Type 


UNO 


C++ 


Java 




contains nElements elements. 


contains nElements elements. 




Exception 


Looks like a stnjcture 


Looks like a structure 


A class which is derived from 
Java. lang. Exception" and 
contains the 

members in the specified order. 


Interface 


The Interface is a pointer to a 
function table, which contains 3 
functions, 


It is a pointer to a C++-Class 
which implements first the 
virtual methods queryinterface. 
acquire and release. 


It is a normal Java interface. 


Any 


This is a staicture that contains 
a 

pointer to a type description. 
The second member is a 
pointer to the 
value stored in the any. 


This is a structure that contains 
a pointer 

to a type description. The 
second memt>er 

is a pointer to the value stored 
In the any. 


A class which is derived from 
java.lang.Objecr. The 
members are a 

class, which describe the type of 
the value. 

A second member which is the 
value of the any. 


Void 


No memory representation 


No memory representation 


No memory representation 



25 

[0886] Many of these types are self-explaining and known in the art. Nevertheless, the most relevant types of the 
type description will be explained in more detail below. 

[0887] "Interfaces": All interfaces employed in connection with the present embodiment are derived from a Super- 
Interface. Each interface contains at least three methods. The two methods "acquire" and "release" are necessary to 
30 control the lifetime of the interface. The third method "queryinterface" is used to navigate between different Interfaces. 
A XInterface includes only these three methods. All other interfaces are derived from this XInterface. The methods and 
functionalities requested by the first software program will be part of the interface. 

[0888] In Java, for example, interfaces are mapped to Java interfaces which could be normally implemented. The 
methods acquire and release are not mapped to the Java program since this methods do not exist in Java. The lifetime 
35 of the proxy, the stub and the relevant information in the second program will be controlled by a garbage collector. The 
programming language Java delivers basic types by value and non-basic types by reference. All calls are specified by 
value except interfaces. So in Java all non-basic types returned or delivered through out parameters are by value, 
which means that the implementation must copy it before return or deliver 

[0889] In C++, for example, interfaces are mapped to pure virtual classes. In orderto automatically control the lifetime 
4Q of interfaces a template called "Reference" will be used. All return, parameter and member types are "References" (e. 
g.: Reference< XInterface >). The "Reference" acquires the interface when it is constructed and releases the interface 
when it is destmcted. 

[0890] "Stmcture": A structure is a collection of elements. The type of each element is fixed and it cannot be changed. 
The number of elements Is fixed. 

45 [0891] "Exceptions": An exception is a program control construct beside the normal control flow. One major feature 
of exceptions is, that it is simpler to implement the error handling. Exceptions are similar to structures' since they are 
also a collection of elements and each type of each element is fixed and cannot be changed and the number of elements 
is also fixed. An additional feature of exceptions is that they can be thrown by a method. All exceptions which can be 
thrown by a method must be declared at the method, except for the called "RuntimeException" which always can occur 

50 All exceptions must be derived from "Exception". If an exception is declared at a method it is allowed to throw all derived 
exceptions. The caller of a method must respond to this beha\^or 

[0892] In Java, for example, all exceptions are derived from the "java.lang. Exception". The exceptions are declared 
at the methods. 

[0893] In C++, for example, the exceptions are generated as structures. An exception is thrown as instance (e.g.: 
55 throw RuntimeExceptionO). At the other side the exception should be caught as reference (. . .catch( RuntimeException 
&){...})• 

[0894] "Union": A union contains one element. The declaration of a union specifies the possible types. 

[0895] "Array": An array contains any number of elements. The type of tiie elements is fixed and cannot be changed. 
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[0896] *'An/*: An any contains one element. All types of elements are possible. An any contains a reference to the 
value and the type description of the type. With the type description the bridge can transform the value, if necessary. 
[0897] In Java the any is. for example, represented by the class "An/, which contains a class as type description 
and a "java.lang.Objecf. which is the value. The basic types are wrapped to their proper classes. For example, a 
boolean value is an object of the class "Java. lang. Boolean", which contains the value. 

[0898] In C++ the any Is represented through the class "Any". Each type generated by a C++ codemaker implements 
an function "getCppuType". This function is used to implement the template access operators "«=" and "»=". These 
operators insert and extract the value of the any 

[0899] "Sequence": A sequence is a generic data type. It contains the number of elements and the elements. In Java 
the specification of an array fulfills this specification. This is not true for C++. The array in C++ does not contain the 
number of elements. It is not possible to return a C++-array, e.g. CharQ getNameQ is not possible. It is difHcult to 
manage the lifetime between the called and the caller, if only a pointer is returned. Therefore, in C++ a sequence is a 
template with the name "Sequence". The implementation contains a pointer to a structure which contains a pointer to 
the elements, the number of elements and the reference count. So It holds the binary specification. It is cheap to copy 
this sequence, because only the reference count is incremented. 

[0900] The type description may exist or it may be runtime created. Each existing type is stored in a type repository 
along with the corresponding type description. The types of the type description are accessible through the full name 
of each type in the type repository. For example, the full name of the type "Xinterface" maybe "com.sun.star.Xinterface". 
[0901] In a type repository the types needed for any type description are stored in any appropriate way. If the API 
(application program interface) of the type repository is c-style, it is directly, that means via a binary representation, 
accessible from many binary specifications and it is quickly transferable. Since the type description of each element 
may t>e used during the generic marshaling of a call, the access performance of the type repository API is critical. 
Therefore, it is useful to use c-style structures, which describe each type. In addition, there may be interfaces declared 
which specify the access to the type repository. The module of this interface is "com.sun.startypelib". 
[0902] All functions or type declarations have the prefix 

"typelib_". All elements are reference counted. All elements start with the structure 
"typelib.TypeDescription". It is possible to cast all descriptions to this type. The function 

typelib typedescription newlnterface will be used to create an interface description. The descriptions of structures, 
unions and sequences are created with the function typelib_typedescription_new. The description of the base type is 
initially part of the type repository. The function to get a type description is typelib_typedescription_getByName. 
[0903] The Java API to the type repository is different for two reasons. First, Java cannot access the binary repre- 
sentation of the type descriptions directly. Second, the Java runtime system provides an API (core reflection) similar 
to the type repository API. Unfortunately, the features "unsigned", "oneway" and "out parameters" are missing in this 
API. For this reason, additional information Is written into the classes. 

[0904] The representation of the types depends on the hardware, the language and the operating system. The base 
type is swapped, for example, if the processor has little or big endian format. The size of the types may vary depending 
on the processor bus size. The alignment is processor and bus dependent. The alignment of the data structure is 
defined through the following algorithm: 

Structure members are stored sequentially in the order in which they are declared. Every data object has an alignment- 
requirement. For stojctures, the requirement is the largest of its members. Every object is allocated an o/feef so that 
offset % alignment-requirement == 0 

[0905] If it is possible that the maximum alignment can be restricted (Microsoft C/C++ compiler, IBM C/C++ compiler) 
than the size maximum alignment is set to eight. Under this condition the alignment is set to mln( n, sizeof( item ) ). 
The size Is round up to the largest integral base type. 

[0906] For the Microsoft and IBM C/C++ compiler the alignment of structure is set to eight using the "#pragma" 
statement. Table 1 shows the binary UNO, C++ and the Java types. 

[0907] In order to address the proxy factory to generate the proxy the first binary specification has to be denominated. 
This will be a string, because it is extensible and the risk of double names is low. Then a tool for selecting the desired 
bridge is called. The first parameter for this tool is the "first binary specification" and the second parameter is the 
intemiediate binary specification "UNO". Then a function is called for selecting the desired mapping of the bridge. The 
name of the function is, in this example, "getMapping Factory". A call to create a proxy in "objective c" will be "getMap- 
pingFactory ("objective_c", "uno")". The implementation of the function will search a shared library named 
"objective_cuno" to find the right library that contains the proxy factory. In Java the tool may search for a class of name 
"objective_cuno". 

[0908] In order to create a stub merely the parameters of the function have to be changed, in our example to "get- 
MappingFactoryruno", "objective.cT. A stub implements the uno.interface. In the dispatch function the stub must 
call the right method of the original object. This is simpler in a programming language like Java, which has a "core 
reflection API", than in a programming language like C++, which has no binary standard and no API to call virtual 
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methods. 

[0909] In creating a proxy the proxy factory must generate method code to implement each method specified in the 
interface to be created. The only information to do this is a type description of the interface. For example: In Java (1.1) 
a binary class file class) must be generated and loaded with the class loader. In the absence of a loader which can 
directly load binary classes a loader has to be provided. In C++ virtual method tables must be generated which delegate 
each call to the uno_interface. In the absence of a binary C++ specification individual compilers (version, switch,...) 
may have to be explored In order to implement this. 

[0910] The proxy and the stub factory employ bridges for the generation of the proxy and the stub, respectively A 

bridge implements infrastructure to exchange interfaces between two environments and is bidirectional 

[0911] An environment contains all objects which suffices the same specification and lies in the same process address 

space. The environment is specific for a programming language and for a compiler. For example, an object resides in 

the "msd" environment, if it is implemented in C++ and compiled with the Microsoft Visual C++ compiler. It may also 

be session specific for some reason, e.g. when running multiple Java virtual machines in one process. In the latter 

case these virtual machines have to be distinguished. However, this case is not a common case. 

[0912] Regularly, the environment is the area in which the same binary specification is employed. Therefore, the first 

software program and the second software program belong to different environments. 

[0913] Each bridge is implemented in a separate shared library. The name of the library is a connection of two 
environment narhes with an underscore ('_') between the names. Each bridge library exports two functions called 
"uno_ext_getMapping'' and "uno.initEnvironment". The first function. is called to get the mappings. 
[0914] In order to get a mapping uno_getMapping() has to be called. There is also a C++ class called cppu_Bridge 
which can be used with the source and destination environment names. The uno_ext_getMapplng() call then receives 
its source and destination environments. The bridge library cannot be unloaded while any code of it is still needed. So 
both mappings and any wrapped interface (proxy) that is exported needs to modify a shared library wide reference 
count. If the shared library can be unloaded the reference count goes to zero. 

[091 5] The intention of an environment structure Is to provide common functions like acquirelnterface() and to know 
all proxy interfaces and their origins. This is specifically Important because of the object identity of an interface. The 
proxy, the stub and the second program are defined to provide the same instance of the XInterface any time It is queried 
for it. This is important to test, if two interfaces belong to the same object (e.g. testing the source of an incoming event). 
[0918] When Interfaces are mapped around some environments in space, they must provide the same XInterface 
in each environment (e.g. in C++, equal XInterface pointers). 

[0917] It is not recommended to only keep an eye on this object identity issue. It is well recommended to reuse any 
interface, i.e. rejecting the production of proxy interfaces as often as possible, because each constructed proxy interface 
leads to another indirection when called, and there will of course be many interfaces. 

[0918] So an environment knows each wrapped interface (proxy) running in it and the origin of each of these inter- 
faces. Table 2 shows the representation of an environment. 
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Table 2: 

struct uno Environment 
( 

/•* 

* a name Cor this environment 
•/ 

rtl String * pName; 

* a free context pointer, that can be used for specific classes 
environments, 

* e.g. a jvra pointer 
*/ 

void ♦ pContext; 
/•* 

* Acquires this environment. 
*<BR> 

* @param pAccess this access interface 
•/ 

void {SAL_CALL * acquire) { uno Environment * pEnv ); 
/*• 

* Releases this environment; 

* last release of environment will revoke the environment from runtime. 
*<BR> 

* Gparam pAccess this access interface 
*/ 

void tSAL_CALL * release) ( uno^Environment ♦ pEnv ); 
/•* 

* Tests if two environments are equal. 
*<BR> 

* 0param pEnvl one environment 

* eparam pEnv2 another environment 
*/ 

sal_Bool (SAL_CALL ♦ equals) [ const uno_Environment • pEnvl, 

~ const uno_E:nviromnent * pEnv2 ); 

/** 

* You register internal and external interfaces via this method. 
Internal interfaces are proxies that are used in an environment. 

* External interfaces are interfaces that are exported to another 

* environment, thus providing an object identifier for this task. 
*' This can be called an external reference. 

* Interfaces are held weakly at an environment; they demand a final 

* revokelnterfaceOcall for each interface that has been registered. 
*<BR> 

* @param pEnv this environment 

* eparam pplnterface inout parameter for the registered interface 
' eparam ppoid inout parameter for the corresponding object id 

* eparam pTypeDescr type description of interface 

* eparam acquire function to acquire an interface; 

* this function provides a boolean return 

* value to signal if the acquisition was successful (necessary for 

* proxy interfaces) 
♦/ 

void (SAL_CALL ♦ register Inter face) ( uno_Environment * pEnv, 

void ** pplnterface, 
rtl_String ppOId, 
typelib_InterfaceTypeDescription 
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pTypeDescr, 

uno regAcquireFtinc acquire ) ; 

/** 

* You have to revoke ANY interface that has been registered via this 

method. 

•<BR> 

♦ eparam pEnv this environment 

• Gparam pOId object id of interface to be revoked 

* eparam pTypeDescr type description of interface to be revoked 

void (SAL_CALL * revoke Inter face) ( uno_Environment * pEnv, 
rtl String ♦ pOId, 

typeXib InterfaceTypeDescription * pTypeDescr ) ; 



20 



30 



/** 

* Retrieves an interface identified by its object id and type from 

* this environment. 
*<BR> 

* epa ram pEnv this enviromnent 

* eparam pplnterface inout parameter for the registered interface; 

* (0) if none was found 

* €pa ram pOId object id of interface to be retrieved 

* epa ram pTypeDescr type description of interface to be retrieved 
V 

void (SAL_CALL * getRegisteredlnterfacel ( uno^Environment * pEnv, 

void ** pplnterface, 
rtl String * pOId, 
typelib_InterfaceTypeDescription * 

pTypeDescr ) ; 
/" 

* Retrieves the object identifier for a registered interface from 
25 * this environment. 

*<BR> 

* eparam pEnv this environment 

* eparam ppOId inout parameter for object id of interface; (0) if none was 

found 

* Eparam pinterface a registered interface 

* eparam pTypeDescr type description of interface 
♦/ 

void (SAL CALL * getRegisteredObjectldentif ier) ( uno__Environment * pEnv, 

rtI_String ppOId, 
void * pinterface, ' 

typelib_InterfaceTypeDe5cription * 

pTypeDescr ); 

35 

* Disposing callback function pointer that can be set to get signalled 

before 

* the environment is destroyed. 
*<BR> 

* eparam pE^v environment that is being disposed 
V 

4Q void (SAL_CALL * environmentDisposing) ( uno_Environment * pEnv ); 

* Computes an object identifier for the given interface; is called by 

* the. environment implementation. 

* <BR> 

* eparam pEnv corresponding environment 
45 * epa r air. ppOId out pa ram; computed id 

* eparam pinterface an interface 
*/ 

void (SAL_CALL * computeObject Identifier) ( uno_Environment * pEnv, 

rtl^String ** ppOId, void * pinterface ); 

50 * Function to acquire an interface. 

*<BR> 

* eparam pEnv corresponding environment 

* eparam pinterface an interface 
'/ 

void (SAL_CALL • acquirelnterf ace) ( uno_Environment ♦ pEnv, void * 
pinterface ) ; 

55 

* Function to release an interface. 
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*<BR> 

* gparam pEnv corresponding environment 

* eparam pInterCace an Interface 
•/ 

void (SAL_CALL * releaselnterf ace ) ( uno^EInvirorunent * pEnv, void * 
5 pinterface ) ; '~ 



[091 9] Environments, as defined above, consist of several fields. The first fields are used for Identifying the environ- 
to ment. for specifying the hardware, the process, and nnayt>e a session specific ID. There Is also a context pointer which 
can be used for specific classes of environments, e.g. when it is known that there is a Java environment the virtual 
machine pointer can be stored there. 

[0920] In order to use environments, these environments regularly have to be registered. An existing environment 
may be obtained by calling uno_getEnvironment(). A new environment can be created by either implementing it directly 

15 or by using a simple default implementation, which is frequently also sufficient, by calling, in the given example, 
uno_createDefaultEnvironment() with the environment's name and its acquire and release function for interfaces. 
[0921] In order to improve the performance the bridges should use the shortest way between two environments. 
Especially, If there are programs instantiated in the identical environment the communication between them should 
be direct and not over a proxy and a stub. 

20 [0922] Mapping isf the direct way to publish an interface in another environment. That means an interface is mapped 
from a source environment to a target environment so that methods may be invoked on a mapped interface in the 
target environment which are delegated to the originating interface in the source environment. A mapped interface 
may also be called a proxy or a stub. Mapping an interface from an environment A to an environment B requires that 
several steps are performed: First, the origin of the interface from environment A has to be retrieved (call getlnterfa- 

25 ceOriginO oh environment A). For this purpose, the environment A looks into its proxy interfaces table to check if there 
is such an interface already known (pointer and type). If the answer is no, then this interface must originally come from 
environment A, or else it must originate from any other environment and Its origin must be known; since each proxy 
interface must have been registered with its origin. Second, an existing proxy interface has to be looked for in envi- 
ronment 6 with the same origin and type (call getlnterface() on environment B). If a proxy interface of that origin and 

30 type IS already in use in environment B, then this interface is acquired, or else a new proxy has to be constructed 
wrapping the source interface from environment A. The fresh proxy interface is then to be registered via registerinterface 
0 on its first acquire() and revoked via revokelnterface() on its last releaseQ from its environment. This second step 
has to be synchronized with other threads in order to get access to mapping tables of an environment by getting an 
access interface (lockAccess()) from the environment. Then an unlockAccess() function has to be called. 

35 

Function of stub and proxy: 

[0923] The stub is encapsulated in an object which delivers and transforms the binary specification adapted calls to 
the stub. This object is the proxy of a stub in the first binary specification. This proxy which calls and attributes access 
40 will be similar with the binary specification from which the call was made. The calling to the stub is shown in Fig. 32. 
[0924] First in step 321 a type save call (e.g. acquire, querylnterface, ...) is made at the proxy 253. This type save 
call will be transformed by the proxy 253 to a con-esponding call in step 322 and dispatched to the stub 254 in step 
323. After that, the return value of this call is transformed in step 324 to the type expected by the binary specification. 
[0925] The proxy is binary specification specific. So it is possible to put this object seamless into the binary specifi- 
cs cation. 

[0926] A stub object is also created which implements an uno.interface and transforms and delegates the calls to 
the second program implemented in a specific programming language (e.g. C++. Java,...). Fig. 33 descrit>es a call 
through a stub 254 to the second program 252. 

[0927] In a first step 331 the dispatch function is called. If proxy and stub are running in the same process, the 
50 dispatch function of the stub is directly called by the proxy. In a distributed environment this is not possible. In this case 
the abstract virtual channel has to provide this functionality. On the proxy side the proxy will accept the request and 
transmit it to the stub side. On the stub side the stub has to call the dispatch function. 

[0928] The stub 254 detects the Interface and the method which should be called at the second program 252. Then 
in step 332 the call was transformed into a specific binary specification by the stub 254 and the second program 252 
55 was called in step 333, After that, the return value was re-transformed to the other binary specification in step 334. 
[0929] The stub makes all transfomnations to the binary specification in which the second program is implemented. 
This is in this example the second binary specification. This makes it possible to implement the second program in the 
second binary specification. For example: In C++ exceptions, multiple inheritance and derivation can be used. In ad- 
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dition to the binary spectfication there are the type descriptions which must be mapped in the binary specification of 
the second program. 

[0930] In order to enable to call from one binary specification or object model to another the stub and the proxy have 
to undergo a binding process. The proxy allows to call from one binary specification to the uno_interface. while the 
stub allows to call through the uno_interface to the second program. The binding of the stub and the proxy is initiated 
by the first software program 251 and is shown in Fig. 34, In a first step 341 the generation of a stub with the binary 
UNO specification In the stub factory 342 is shown. In a second step 343 a proxy is created based on the generated 
stub in the proxy factory 344. 

[0931] Each call to the proxy is delivered to the stub. The stub prepares the call and calls the second program in the 
corresponding binary specification. Fig. 35 shows exemplary the call from a first software program 251 in a programming 
language like "objective c" to a second software program 252 which may be implemented in the programming language 
C++. 

[0932] The first software program 251 uses the programming language "objective c". The proxy 253 makes the 
interface available to the first software program 251 in the first binary specification. This means the first software 
program 251 uses the first binary specification to manipulate the second software program 252. For example, this may 
be effected by the call "char * pOldText = [myObject changeText: "test"]" in step 351. The proxy 253 transforms the 
parameter of type string to the binary specification in step 352. Then, the proxy 253 dispatches in step 353 the call to 
the stub 254. The necessary infomnation, including a method type description, parameters, an address for the return 
value and an address for the exception, if any occurs, is delivered to the stub 254. The stub 254 transforms in step 
354 the string from the binary UNO specification to a second binary specification string. The stub 254 calls the right 
method at the second software program 252 in step 355. in our example "pComponent->changeText("test^". The stub 
254 must catch all kind of exceptions thrown by the second software program 252. If the method returns normally the 
string is transformed in the step 356 to the binary UNO specification and stored at the place given through the dispatch 
call. If an exception is thrown, the exception is transformed and stored at the address given through the dispatch call. 
After the dispatch call retums the proxy 253 transforms in step 357 the string to a first binary specification string and 
returns from the "changeText" call. If the call terminates by an exception, the exception is returned to the first software 
program 251 . It is up to the first binary specification in which manner the exception occurs (the "objective c" language 
does not support exception handling). 

[0933] Fig. 36 shows the advantage of the binary UNO specification as an intennediate binary specification as it was 
described above. In a first step 361 the first software program 251, for example written in the programming language 
C++, transmits one command in a first binary specification, in this example the command "setText("a test")", to the 
proxy 253. Regulariy, the first software program will transmit more than one command, for example, also the acquire, 
the release and the query Interface command as described above. This command will be transformed by the proxy 253 
in the next step 362 from the first binary specification into the binary UNO specification. The command in the binary 
UNO specification contains the following information: the parameter "a tesr, the retum address, an address for the 
exceptions, and the type description of the command "setTexr. The type description of this command will include, in 
this example, the name of the command (setText), the type of the parameter and the retum type. This transformed 
command will be transmitted to the stub 254 in the step 363. Then, the stub 254 transforms in step 364 the command 
from the binary UNO specification into the second binary specification, employed by the second software program 252 
which was written, for example, in the programming language Java. The stub 254 employs for this transforming step 
only one dispatch mechanism. This is a mechanism which will be employed for each command transmitted by the 
proxy 253, sirice it is able to dispatch the name of the commarid and the other relevant information to the second 
software program 252. In the final step 365 the second software program 252 executes the command "setText". The 
response to this command will be transmitted and transformed in a corresponding way 

[0934] Fig. 37 shows a scenario where between the proxy 253 and the stub 254 an interceptor 370 is inserted. This 
means, that the stub 254 and the interceptor 370 are created in a first step, while in a second step the stub 253 is 
created tiased on information about the stub 254 and the interceptor 370. Therefore, the proxy 253 will communicate 
only with the interceptor 370 and not with the stub 254. 

[0935] Such an interceptor may be able to can7 out. for example, an accounting function or a security check function. 
If. for example, the first software program 251 wants to use a functionality of the second software program 252, the 
interceptor may be able to discover if the user of the first software program is authorized to use this function and to 
debit the account of the user, if the user has to pay for this functionality. Such an interceptor may also be used, for 
example, to help debugging the communication between a first software program 251 and a second software program 
252. In such a case the interceptor may provide an alarm function which will be initiated, if a predefined functionality 
is called. If the functions requested from the second software program 252 may be grouped as one transaction, it may 
also be possible that an interceptor cancels all already executed functions of this group, if one function fails. Such an 
interceptor has the advantage that only one interceptor may be employed for every function or method of an interface 
and for all binary specifications of software programs which communicate via the intermediate binary specification 
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used by the stub 254 and the proxy 253. 

[0936] Fig. 38 shows a flow chart representing the use of an interceptor as checking and accounting function for a 
fax service. In this example, a user of a first software program using a first binary specification wants to use the fax 
service of a second software program using a second binary language. This fax service may distinguish between two 
5 kinds of users. A standard user may have to pay for each fax and a premium user may have to pay a monthly standard 
fee. 

[0937] In order to enable the communication between the two software programs a stub and a proxy will be created 
and combined and arranged together with a specific interceptor in a way shown in Fig. 37. Then, the following steps 
may be carried out in using the invention. 
10 [0938] In step 3800 the first software program sends a command including the desired fax number, tiie con^sponding 
fax file and the identity of the user to the proxy. The proxy transforms this command into the intermediate binary spec- 
ification and forwards it to the interceptor in step 3801. The interceptor checks in step 3802 v^ether the user is a 
standard user. 

[0939] If the answer is '^es", that means the user is a standard user, the interceptor may deteremine in step 3803 
15 whetiier the user has enough credit. If the answer to this question is "No", the user will be informed about his insufficient 
credit status and about the fact that the fax was yet not sent in step 3804. If the answer is "Yes", that means that the 
user has enough credit, the interceptor will initiate, in this example, tine debiting of the user's account In step 3805 and 
fonward the received command to the stub In step 3806. 

[0940] If tiie answer in step 3802 is "No", that means tiie user is a premium user, the interceptor will fonvard the 
20 command received from the proxy directiy to the stub in step 3806. The stub will transfomri this command from the 
intermediate binary specification into the second binary specification and forward this command to the second software 
program in step 3807. Then the fax may t>e sent. 

[0941] In the following further embodiments for dynamically dispatching function calls from a first execution Environ- 
ment to a second execution environment will be described. 

25 

1 ) A method for enabling a first software program using a first binary specification in a first execution environment 
to employ a limited functionality of a second software program using a second binary specification In a second 
execution environment, the method comprising: 

30 creating a bridge in said first execution environment; and 

creating. In said first execution environment using said bridge, a proxy wrapping an Interface to said limited 
functionality of said second software program in said second execution environment. 

35 2) A method as in 1) further comprising: 

creating a first execution environment object including said second binary specification, 

3) A method as in 2) fijrther comprising: 

creating a second execution environment object Including said first binary specification. 

40 

4) A method comprising: 

generating a binary specification object for a first execution environment; 

45 generating a binary specification object for a second execution environment; and 

generating a bridge object wherein said bridge object is used in mapping objects from said second execution 
environment to said first execution environment. 

so 5) The method of 4) further comprising: 

using said bridge object to generate a proxy wrapping an interface in said second execution environment. 

6) A method for using functionality in a second execution environment in a first execution environment comprising: 

55 calling a method in a proxy interface in said first execution environment; and 

converting said method call by said proxy interface to a con-esponding method call for execution In said second 
execution environment. 
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7) The method as in 6) further comprising: 

dispatching said corresponding method call for execution in said second execution environment to said second 
execution environment by said proxy interface. 

8) The method of 6) where said converting said method call further comprises: 

using a type description to convert parameters from said first execution environment to said second execution 
environment. 

9) The method of 7) further comprising: 

executing said corresponding method call In said second execution environment, and retuming results of said 
execution to said proxy interface. 

10) The method of 9) further comprising: 

using a type description to convert said retumed results from said second execution environment to said first 
execution environment. 

11) The method of 6) wherein said second execution environment is a C++ programming language execution 
environment. 

1 2) A method for using functionality in a second execution environment in a first execution environment comprising: 
calling a method in a proxy interface in said first execution environment; 

converting said method call by said proxy interface to a corresponding method call for execution in said second 
execution environment, wherein said converting said method call comprises: 

using a type description to convert parameters from said first execution environment to said second execution 
environment; and 

dispatching said con-esponding method call for execution in said second execution environment to said second 
execution environment by said proxy interface. 

1 3) The method of 12) further comprising: 

executing said con-esponding method call in said second execution environment, and retuming results of said 
execution to said proxy interface. 

14) The method of 13) further comprising: 

using a type description to convert said retumed results from said second execution environment to said first 
execution environment. 

In the following a further embodiment of a computer program product will be described. 

15) A computer program product comprising computer program code for a method for enabling a first software 
program using a first binary specification in a first execution environment to employ a limited functionality of a 
second software program using a second binary specification in a second execution environment, the method 
comprising: 

creating a bridge in said first execution environment; and 

creating, in said first execution environment using said bridge, a proxy wrapping an interface to said limited 
functionality of said second software program in said second execution environment. 

16) The computer program product of 15) wherein said method further comprises: 
creating a first execution environment object including said second binary specification. 

17) The computer program product of 16) wherein said method further comprises: 
creating a second execution environment object including said first binary specification. 

18) A computer program product comprising computer program code for a method for using functionality in a 



202 



EP1 126 681 A2 



second execution environment in a first execution environment, said method comprising: 
calling a method in a proxy interface in said first execution environment; and 

converting said method call by said proxy interface to a corresponding method call for execution in said second 
execution environment 

19) The computer program product of 18) wherein said method further comprises: 

dispatching said corresponding method call for execution in said second execution environment to said second 
execution environment by said proxy Interface. 

20) The computer program product of 18) wherein said method further comprises: 

using a type description to convert parameters from said first execution environment to said second execution 
environment, 

21) The computer program product of 19) wherein said method further comprises: 

executing said con-esponding method callln said second execution environment, and retuming results of said 
execution to said proxy interface. 

22) The computer program product of 21) wherein said method further comprises: 

using a type description to convert said returned results from said second execution environment to said first 
execution environment. 

A computer storage medium may have the following elements. 

23) A computer storage medium having stored therein a structure comprising: 
a binary specification for an execution environment including: 

a simple common identity structure. 

24) The computer storage medium of 23) wherein said binary specification further comprises: 
an extended environment structure. 

25) The computer storage medium of 23) wherein said simple common identity structure Includes: 
a type name. 

26) The computer storage medium of 23) wherein said simple common identity structure includes: 
a method acquire. 

27) The computer storage medium of 23) wherein said simple common identity stnjcture includes: 
a method release. 

28) The computer storage medium of 24) wherein said simple common identity structure includes: 
a pointer to said extended environment structure. 

29) A method for enabling a first software program using a first binary specification to employ a limited functionality 
of a second software program using a second binary specification, including the following steps: 

a) initiating Ihe creation of a stub, which Is able to transform commands relating to said limited functionality of 
said second software program between said second binary specification and an intermediate binary specifi- 
cation, using a second bridge, wherein said second bridge provides a mapping of said second binary speci- 
fication and said intermediate binary specification, 

b) initiating the creation of a proxy, which is able to transform commands relating to said limited functionality 
of said second software program between said first binary specification and said intermediate binary specifi- 
cation, using a first bridge, wherein said first bridge provides a mapping of said first binary specification and 
said intermediate binary specification, and 
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c) initiating the arrangement of said proxy and said stub relatively to said first software program and said 
second software program in a manner allowing said first software program to employ said limited functionality 
of said second software program. 

5 30) A method for employing a limited functionality of a second software program using a second binary specification 

by a first software program using a first binary specification, including the following steps: 

a) initializing said limited functionality of said second software program by said first software program, 

10 b) creating a stub, which is able to transform commands relating to said limited functionality of said second 

software program between said second binary specification and an intermediate binary specification, using a 
second bridge, wherein said second bridge provides a mapping of said second binary specification and said 
intermediate binary specification, 

15 c) creating a proxy, which Is able to transform commands relating to said limited functionality of said second 

software program between said first binary specification and said intennediate binary specification, using a 
first bridge, wherein said first bridge provides a mapping of said first binary specification and said intermediate 
binary specification, 

20 d) transmitting an command relating to said limited functionality from said first software program to said proxy. 

e) transforming said command from said first binary specification into said intermediate binary specification 
by said proxy, 

25 f) transmitting said command transformed by said proxy from said proxy to said stub, 

g) transforming said transmitted command from said intermediate binary specification into said second binary 
specification by said stub. 

30 h) transmitting said command transformed by said stub from said stub to said second software program, 

t) canying out said command in said second software program and generating a response for said first software 
program, 

35 j) transmitting said response, being in said second binary specification, from said second software program 

to said stub, 

k) transforming said response from said second binary specification into said intennediate binary specification 
by said stub, 

40 

I) transmitting said response transformed by said stub from said stub to said proxy, 

m) transforming said response from said intermediate binary specification into said first binary specification 
by said proxy, 

45 

n) transmitting said response transformed by said proxy from said proxy to said first software program. 

31) A method for using a stub, which is able to transform commands relating to a limited functionality of a second 
software program between a second binary specification and an intermediate binary specification, using a second 

50 bridge, wherein said second bridge provides a mapping of said second binary specification and said intermediate 

binary specification, for enabling a first software program using a first binary specification to employ said limited 
functionality of said second software program by further using a proxy, which is able to transform commands 
relating to said limited functionality of said second software program between said first binary specification and 
said intermediate binary specificafion. using a first bridge, wherein said first bridge provides a mapping of said first 

55 binary specification and said intennediate binary specification, wherein said proxy and said stub are an-anged 

relatively to said first software program and said second software program in a manner allowing said first software 
program to employ said limited functionality of said second software program. 
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32) A method for using a proxy, which is able to transform commands relating to said limited functionality of said 
second software program between said first binary specification and said intermediate binary specification, using 
a first bridge, wherein said first bridge provides a mapping of said first binary specification and said intermediate 
binary specification, for enabling a first software program using a first binary specification to employ said limited 

5 functionality of said second software program by further using a stub, which is able to transform commands relating 

to a limited functionality of a second software program between a second binary specification and an intermediate 
binary specification, using a second bridge, wherein said second bridge provides a mapping of said second binary 
specification and said intermediate binary specification, wherein said proxy and said stub are arranged relatively 
to said first software program and said second software program in a manner allowing said first software program 

10 to employ said limited functionality of said second software program. 

33) A method according to any of 29) - 32), wherein said creation of said stub is earned out in response to a loader 
function for said second software program. 

15 34) A method according to any of 29) - 33), wherein said creation of said proxy is carried out in response to a 

function of said first software program. 

35) A method according to any of 29) - 34), wherein said creation of said stub is carried out by a sub-program of 
the second software program. 

20 

36) A method according to any of 29) - 35). wherein said creation of said proxy is earned out by a sutnprogram of 
the first software program. 

37) A method according to any of 29) - 36), wherein said bridges are selected by a tool for selecting the desired 
25 bridge. 

38) A method according to any of 29) - 37), wherein said mappings are selected by a function for selecting the 
desired mapping of the bridge. 

30 39) A method according to any of 29) - 38), wherein said limited functionality is described by types. 

40) A method according to 39), wherein the types are stored in a type repository. 

41) A method according to 40), wherein the types are stored in said type repository along with the con^esponding 
35 description. 

42) A method according to 40) or 41), wherein a application program interface of said type repository is c-style. 

43) A method according to any of 29) - 42), wherein said first binary specification and said second binary specifi- 
40 cation are denominated by a string. 

44) A method according to any of 29) - 43), wherein an interceptor is an^nged between said proxy and said stub 
in order to intercept some of said commands. 

45 45) A method according to any of 29) - 44), wherein said stub is able to transform alt commands transmitted by 

the proxy by employing one dispatch mechanism. 

46) A computer program for carrying out a method according to any of 29) - 45) on a computer system. 

50 47) A data carrier for storing a computer program for carrying out a method according to any of 29) - 45) on a 

computer system. 

48) A method for using a computer system for carrying out a method according to any of 29) - 45). 

55 49) A computer system comprising a storage medium on which a computer program for carrying out a method 

according to any of 29) - 45) or 48) is stored. 
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Abstract of CHAPTER B 

[0942] A methcxj for enabling a first software program using a first binary spedfication in a first execution environment 
to employ a limited functionality of a second software program using a second binary specification in a second execution 
5 environment first creates a bridge in the first execution environment. Using the bridge, a proxy wrapping an interface 
to the limited functionality of the second software program in the second execution environment is created in the first 
execution environment. The proxy is used to access the limited functionality of the second software program in the 
second execution environment. 

10 CHAPTER C 

[0943] CHAPTER C describes a method and system for remote control and interaction with a run time environment 
component, e.g. in the networic portal system of CHAPTER A. 

^5 BACKGROUND 

Field . 



[0944] Chapter C relates to runtime environment component services, and in particular to a runtime environment 
20 component services provided by a first computer system to a second computer system over a communication network, 
e.g. in the network portal system of CHAPTER A. 

Description of Related Art 

25 [0945] Today, many computer networics are arranged as client-server systems. In a client-server system, a potentially 
large number of smaller computer systems, like laptops or handhold organizers, called clients, are, temporarily or 
permanently connected to a larger computer system, called server. The connection between the clients and the sender 
may be effected, for example, via the Internet. 

[0946] In client-server systems, a client typically has limited storage and processing capabilities. Nevertheless, many 
30 software programs are executed on the clients. One prior art way to make a software program on the server available 

to clients was to use a browser on the client. The browser was used to transfer a relatively large software program or 

a relatively large part thereof from the server to a client so that the software program could be executed locally on the 

client. This method required that the software program or a part thereof be stored and processed on the client. 

[0947] For this purpose, the client must have sufficient storage capacity and processing capability to execute the 
35 software program locally These requirements may conflict with the aim of having smaller and smaller clients, including 

cellular telephones, which may not have enough storage capacity or processing capability for storing or processing, 

respectively, large software programs or large parts of software programs. 

[0948] Frequently, a software program requested by a client for execution is transferred every time the software 
program is executed. The speed of this download depends on the available data transfer capacity of the network 
40 connecting the server and the client. Here, frequently the available bandwidth of the network connection is decisive. 
In many instances the described client-server systems would be undesirably slow in executing a software program, 
because the download takes too much time. 

[0949] Therefore, software programs, which are called frequently for execution on a client, may be permanently, or 
at least for some time, stored on the client. This leads, however, to the task of regulariy, and maybe even individually, 
45 updating a potentially large number of clients, if relevant software programs are amended or updated. Considerable 
administration efforts for client-server systems may be the consequence. 

[0950] It is also known to include into a software program executed on a client procedures, which are executed on 
a server. A prior technique to implement this used CORBA. For example, certain more complicated calculations, the 
result of which may be needed on a client, were earned out on a server connected with the client over a networtc. 
50 However, this required that the program developer include particular commands into the code of the software program 
to be executed on the client for calling the software program to be executed on the server, in the given example the 
calculation program. This was not only cumbersome, but also led to incompatibilities when the software program to be 
executed on the server was amended. 

[0951] It is further known to allow a user to initiate execution of a program server from a client and to review the 
55 results of the program execution on the client. This approach is used in the UNIX X-Windows system. However, this 
approach did not permit the client to control the program and did not permit integration of server side functionality into 
the client side environment at the level of function calls. 
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SUMMARY 

[0952] It is desirable to provide Improved access from a first computer system to resources available at a second 
computer system. 

5 [0953] According to one embodiment, a user device, a first computer system, includes a lightweight component that 
receives user input actions for a runtime environment component that is executing on a second computer system. The 
lightweight component sends a remote input action command to a user interface infrastructure that is executing on the 
second computer system. 

[0954] In response to the remote input action command, the user interface infrastructure sends a local input action 

10 command to the runtime environment component that processes the command, and issues a local output command 
to the user interface infrastructure that in tum sends a remote output command to the lightweight component on the 
user device. In response to the remote output command, the lightweight component causes an output on the user 
device. This output could be redrawing a display, playing a sound, or perhaps routing information to a local printer. 
[0955] All the management of components in the user interface, management of data and so on is performed on the 

15 second computer system and so the lightweight component only has, for example, to update tiie display to reflect the 
state of the runtime environment component as indicated, by the remote output command received. It appears to the 
user that the runtime environment component is executing locally on the user device despite that fact that the user 
device is only functioning as an input/output device for the runtime environment component. 
[0956] In one embodiment, a method for presenting a runtime environment component service by a first computer 

20 system to a second computer system over a communication network is performed by the first computer system. The 
method includes generating a user interface infrastructure on the first computer system. The user interface infrastmc- 
ture receives graphic user interface events from the second computer system and sends remote graphic user interface 
commands to the second computer system. The user interface infrastructure is used to initialize the runtime environ- 
ment component sen^ice. The runtime environment component service sends graphic user interface commands to the 

25 user interface infrastmcture. 

[0957] In another embodiment, the first computer system receives a remote input action command for a runtime 
environment component service via a communication network. The remote input action is being generated in the second 
computer system by a lightweight component corresponding to the runtime environment component sen/ice. A local 
input action command is transmitted to the runtime environment component service in response to the remote input 

30 action command. The local input action command is processed by the runtime environment component service, and 
a local output command is generated by the runtime environment component sendee for a graphical user interface. A 
remote output command is ti*ansmitted to the lightweight component in response to the local output command. 
[0958] In yet another embodiment, a metiiod for enabling a user device to run a runtime environment component on 
another computer includes running a browser on the user device. A lightweight component is run within the browser. 

35 The lightweight component receives user input actions on the user device and generates con-esponding user interface 
events to the another computer for processing by the runtime environment component. 

[0959] A computer program product, in one embodiment, comprises computer code including a remote frame window 
class that in turn includes a remote output device interface and a remote frame window interface. The computer code 
optionally includes any or all of a bean frame class comprising a frame interface; a bean window class including an 
40 event handler interface and a window peer interface; and an abstract windowing toolkit. 

[0960] According to a further emtKxJiment a metiiod is provided for presenting runtime environment component serv- 
ices by a first computer system to a second computer system over a communication network, said method being 
performed by said first computer system, and comprising the steps of: 

45 a) receiving a request for a runtime environment component service via said communication network, said request 

being generated by a lightweight component in said second computer system, wherein the lightweight component 
corresponds to the requested runtime environment component service, 

b) accessing a runtime environment component being able to provide said requested runtime environment com- 
50 ponent, service, 

c) executing said mntime environment component on said first computer system for producing a result according 
to said received request for a runtime environment component service, 

55 d) transmitting, over said network, a response comprising said result to said second computer system. 

[0961] The invention comprises also a method for providing runtime environment component services from a first 
computer system over a communication network to a second computer system, said method being executed on said 
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second computer system and comprising the steps of: 

a) generating a request for a mnttme environment component service by means of a lightweight component of 
said second computer system, wherein the lightweight component corresponds to the requested runtime environ- 
ment component service, 

b) transmitting said request for said runtime environment component service to said first computer system over 
said communication network, and 

c) receiving a response comprising a result according to said requested runtime environment component service, 
said result being produced by a runtime environment component executed on said first computer system and 
transmitted with said response by said first computer system over said network. 

[0962] Thus, the runtime environment component services are presented by a first computer system to a second 
computer system over a communication network, whereby upon receiving a request for a runtime environment com- 
ponent service transmitted by said second computer system over said communication network, the first computer 
system executes a runtime environment component for producing a result according to said received request, and 
transmits - over said network - a response comprising said result to said second computer system. 
[0963] In the context of the present invention a lightweight component Is a software program which is able to request 
a runtime environment component service, wherein the lightweight component con-esponds to this runtime environment 
component service, and wherein the lightweight component Is tiny enough to be downloaded from the first computer 
system onto the second computer system via the network connecting the first with the second computer system within 
a time t significantly smaller than the time it would take to download the whole runtime environment component to 
which it corresponds. 

[0964] The time t shall partlculariy, but not necessarily, be less than (8 N / Cb) + t^, wherein N is the size of the 
runtime environment component in bytes, Cg Is the average bandwidth of the network connection between the first 
and the second computer system, and t^ is the time needed to initialize the runtime environment component providing 
the requested service In Its respective local environment on the first computer system. In today's commonly available 
network connections between servers and clients the time t will typically be about ten seconds. 
[0965] When using networks commonly used at present for the connection of clients and servers this time condition 
amounts to a scope of the lightweight component which is - measured in necessary storage space - less than ten or 
even less than five percent of the scope of the totality of the runtime environment components which can be requested 
by it, including any auxiliary software programs which these runtime environment components need to be executed in 
the first computer system. 

[0966] Con^espondence of the lightweight component with the runtime environment component service means, in 
this context/ that the lightweight component must offer the second computer system access to the runtime environment 
component service made available by it. If a plurality of runtime environment component services is made available 
by the lightweight component, which will frequently be the case, the lightweight component corresponds to this plurality 
of runtime environment component services In the explained sense. 

[0967] The inventive methods enable a second computer system to use results produced by a first computer system. 
The load of holding, maintaining and administrating these runtime environment components, as well as executing these 
runtime environment components, is burdened onto said first computer system. Nevertheless, said second computer 
system can profit from these runtime environment component services as if the relating runtime environment compo- 
nents were present locally on said second computer system. Therefore, additional functionality is provided even to 
those computer systems which are not powerful enough to store and / or execute the full range of mntime environment 
components, as for example notebooks, handheld computers, organizers and mobile telephones. Since said first com- 
puter system and said second computer system exchange requests for services and responses to said requests, rather 
than exchanging programming code to perform the services, the amount of data transfer t)etween both computer sys- 
tems is considerably reduced. This shortens communication time (on-line time) and leads to faster running software 
programs on the second computer system. 

[0968] The Inventive methods are partlculariy interesting for use with a client/server environment. In that case, the 
first computer system takes over the role of a server, whereas the second computer system is one of the clients. The 
networic may be a local network or a wide-area networi(, as for example the Internet 

[0969] As an example, said runtime environment component services may relate to graphic functions, word process- 
ing functions, document editing functions, mathematical functions, table calculation functions, or printing functions. 
Said runtime environment components may be, for example, of the form of application programming interfaces or 
runtime components. 

[0970] The runtime environment component services offered by the first computer system are requested, according 
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to the present invention, by means of a request generated by a lightweight component on the second computer system. 
This lightweight component may issue this request in response to a call of a software program being executed on the 
second computer system. However, the lightweight component may also be or have a user interface, so that no addi- 
tional software programs need to be executed on the second computer system. 
5 [0971] The runtime environment components as well as possible software programs calling for their services may 
comprise compiled program code to be executed or script code to be interpreted. 

[0972] As a general advantage of the invention, all the characteristics of the runtime environment components re- 
siding on said first computer system, for example a program interface and a runtime environment, can be made fully 
available for use by said second computer system. If new components or releases of components are added to said 
10 first computer system, these can be made immediately available to the second computer system without any significant 
modifications or additions required on said second computer system. This central administration of runtime environment 
components reduces the load of administration on said second computer system and on a client/sender system in 
general. 

[0973] Said request and / or said response sent over said communication networic may be compliant with a prede- 
15 termined communication protocol, in particular with the Internet protocol. 

[0974] In particular, if the communication network is an open wide-area network, said request and / or said response 
may be transmitted over secure channels. For example, encryption / decryption technologies may be applied for the 
communication between said computer systems. 

[0975] Said request and / or said response may comprise identification data of said first computer system, identifi- 
20 cation data of said second computer system, identification data of said runtime environment component service, and 
input data to said runtime environment component service. 

[0976] it is to be understood that said first computer system may present said runtime environment component serv- 
ices to an arbitrary numt>er of second computer systems independently from each other. On the other hand, a second 
computer system may transmit its requests selectively to different first computer systems. The communication network 
25 may be of any type suitable for communication between computer systems, including wired and partially or totally 
wireless. The computer systems may be of any type of processing environments, and of any size. They may be em- 
bedded into other systems. 

[0977] The invention can be implemented by a computer system comprising computer program code or application 
code. Computer program code or application code may be embodied in any form of a computer program product. A 

30 computer program product comprises a medium configured to store or transport computer-readable code, or in which 
computer-readable code may be emt>edded. Some examples of computer program products are CD-ROM disks, ROM 
cards, magnetic disks or tapes, service on a network, and carrier waves. The computer program product may also 
comprise signals which do not use carrier waves, such as digital signals transmitted over a network. The computer 
program product may then be implemented as any transmission link, such as a connection to the Intemet, or any LAN, 

35 WAN, telephone network, or the like. 

[0978] Further, the invention comprises runtime environment components for use with a method according to the 
Invention. In particular, the invention also comprises a data base comprising runtime environment components relating 
to said sendees according to any of the inventive methods. 



40 BRIEF DESCRIPTION OF THE DRAWINGS OF CHAPTER C 
[0979] 

Fig. 1 is an illustration of one embodiment of the present invention, with a plurality of user devices 

45 that each can execute a lightweight component that corresponds to at least one component 

on the server computer system; 

Fig. 2 Is a more detailed illustration of one embodiment of the present invention with a representative 

user device that executes a lightweight component that con^esponds to at least one component 
50 on the server computer system; 

Fig. 3 is a process flow diagram for one embodiment of the present invention; 

Fig. 4 is an architecture diagram for one embodiment of the present invention; 

55 

Figs. 5A to 5D are a sequence diagram for a JAVA-based implementation of one embodiment of the present 

invention; 
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Fig. 6 is a class diagram for the embodiment of the present invention illustrated in Figs. 5A to 5D; 

Fig. 7 Is a cross-reference between Tables in the description and selected interfaces in Fig. 6; 

5 Figs. 8A to 8C are a cross-reference between Tables in the description and selected interfaces in Fig. 6; 

Fig. 9 is a cross-reference between Tables In the description and selected interfaces in Fig. 6; 

Figs. 10A and 1 0B are a cross-reference between Tables in the description and selected interfaces In Fig. 6; 

10 



Fig- 


11 


gives a general overview of an implementation of the invention; 


Fig. 




iiiusiraies me processing ot a requesi uy a remoie server TrarTieworK, 


Fig. 


13 


Illustrates an impiemeniauon ox a iigniweigni component, 


Fig. 


14 


illustrates the transparent access via an object component model; 


Fig. 


15 


illustrates an implementation of a visual lightweight component; 


Fig. 


16 


illustrates remotely drawing; 


Fig. 


17 


illustrates accessing an API; 


Fig. 


18 


illustrates the creation of a Java bean lightweight component; 


Fig. 


19 


illustrates relating a StarOfficeBean frame window; 


Fig. 


20 


gives a flow chart for an example using the present invention; 


Fig. 


21 


illustrates a client's view of a non-visual lightweight component; and 


Fig. 


22 


illustrates a client's view of a visual lightweight component. 



35 [0980] In the Figures 1 - 22 of CHAPTER C and the following Detailed Description of CHAPTER C, elements with 
the same reference numeral are the same element or a similar element. Also, the first one or two digits of a reference 
numeral for an element indicate the figure in which that element first appeared. Reference numerals do not necessarily 
correspond to the reference numerals used in the further chapters. A word in italics and the same word not in italics 
represent the same element. The italics are used only for convenience and not to denote different embodiments or 

40 elements. 

DETAILED DESCRIPTION 

[0981] According to one embodiment of the present invention, a user can access and use applications or services. 

45 e.g., application 112 in a suite of applications 120, on server computer system 100 from almost any available device, 
e.g., any one of a portable computer 102A, a mobile telephone 102B, a workstation 102C, a home personal computer 
(PC) 102P, a personal digital assistant 102E, or an Internet cafe machine 102F. No longer is a user limited to using 
either workstations and/or portable computers with suite of applications 120 installed thereon. 
[0982]: For example, a user on a vacation overseas suddenly realizes that the presentation her boss is going to 

50 deliver the next morning contains a critical error The user drops by an Internet cafe and from any machine 102F at 
the cafe accesses the presentation via server computer system 100, and makes the necessary corrections using ap- 
plications written, for example, in a visual basic programming language and/or the C++ programming language even 
though only a browser is available on machine 1 02F 

[0983] In another scenario, the user is having dinner at a friend's house, and gets an urgent call saying that a report 
55 that can be assessed via server computer system 100 must be revised that everiing. The revisions will not require 
much work, but the trip to the office and back is a very unwelcome prospect. Using the friend's PC 1 02 D and the friend's 
Internet service provider, the user works on the report without leaving his friend's home even though no software for 
accessing application suite 120 is available on PC 102D. The user interface on PC 102D and the application capability 
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is that same as if the user were executing the application at the ctfice. 

[0984] Another user is expecting an important document, but the user has a business appointment outside the office. 
The document arrives by e-mail while the user Is in transit. Using a PDA 102E while on the train, the user accesses 
the e-mail using server computer 100. reviews the document, and then re-directs the document to the fax machine at 
5 the site to which the user is going. 

[0985] A customer would like to meet with a user tomorrow. The user thinks he will be available, but the user doesn't 
know whether anyone scheduled the time white the user was away from the office, and now the ofHce is closed. Using 
a mobile telephone 102B, the user accesses his up-to-the-minute calendar via server computer system 1 00 and sched- 
ules the appointment. 

10 [0988] Hence, in one embodiment, using a web browser and an Internet connection, the user simply logs on to a 
web server 111 , and proceeds as though everything were locally resident on his/her machine. While execution actually 
takes place on server computer system 100, this fact is transparent to the user. Similarly, local services available on 
a client system, including devices like printers and local storage, can be utilized in a transparent manner. 
[0987] In addition to using browsers, users can access applications on server computer system 100, sometimes 

15 called server 100. from Wireless Application Protocol (WAP) devices, which include mobile phone 102B and perhaps 
PDA 102E. Because of the limited capabilities of devices 102B and 102E, functionality is not as extensive as from a 
system that can run a full browser. Accordingly, in one embodiment, users are able to view their mail and data, but 
users don1 have full editing capabilities in this embodiment. However, users can use mobile phones and PDAs to 
manage their data and the users can direct the movement of information to other devices. 

20 [0988] Hence, a user of any one user device 102i, where i is A to G. of a plurality of devices 102A to 102G can use 
an application 112, or any other application in suite 120 that can include for example a word processing application, a 
spreadsheet application, a database application, a graphics and drawing application, an e-mail application, a contacts 
manager application, a schedule application, and a presentation application, as if that application were executing locally 
on user device 1021. One office application package suitable for use with this invention, is the STAROFFICE Application 

25 Suite available from Sun Microsystems, 901 San Antonio Road, Palo Alto, CA. (STAROFFICE is a trademark of Sun 
Microsystems. Inc.) The user has access to the functionality of application 112 even in situations where user device 
102i has neither the memory capacity nor the processing power to execute application 112. 

[0989] As explained more completely t)elow, in each of the above examples, a lightweight component 230 (Fig. 2) 
is either stored locally in a memory of user device 102i. or is downloaded from server computer system 100(Fig. 2) to 
30 memory 211 in user device 102i. Lightweight component 230, in the embodiment, is loaded in a browser, to commu- 
nicate over a network, e.g., enterprise network 103, Intemet 106, or a combination of the two 103/106, with application 
112 that is executing on server computer system 1 00. 

[0990] Lightweight component 230, as explained more completely below, is not a prior art software program. Rather 
lightweight component 230. in one embodiment, maps visual display instructions from application 112 executing on 
35 server computer system 100 to a platform dependent graphic layer that in turn generates a user interface on display 
screen 295 of monitor 216. The user interface for application 112 is similar to the user interface that the user would 
see if application 112 were executing locally on device 1021. The interfaces may not be identical if user device 1021 
has limited input/output capability, e.g., user device 102i is a mobile telephone. 

[0991] When lightweight component 230 receives an input event from the windowing environment executing on user 
40 device, e.g., the JAVA Abstract Windowing Toolkit (AWT), lightweight component 230 transmits the event to application 
1 12 for processing. Here, the input event could be selection of a menu item, configuration of a menu, a keyboard input, 
a mouse input, or any other input event supported by application 112. 

[0992] Application 112, executing on server computer system 100 processes the event received from lightweight 
component 230 and performs any operations required on server computer system 100. Output instructions from ap- 

45 plication 112 are directed to lightweight component 230 on user device 102i. 

[0993] When lightweight component 230 receives the output instructions, lightweight component 230 executes the 
instoictions. For example, if the instructions are to update the display, lightweight component 230 maps the instruction 
to a platform dependent graphic layer that in turn redraws the display All the management of components in the user 
interface, management of data and so on is performed on server computer system 100 and so lightweight component 

50 230 only has to update the display to reflect the state of application 1 1 2 as indicated by the output instructions received 
from application 112. 

[0994] Consequently it appears to the user that application 112 is executing locally on user device 1021 despite that 
fact that user device 1 02i is only functioning as an input/output device for application 112. Lightweight component 230 
on user device 1 02i routes the output to an output device of device 1 02i, e.g., a display unit 216 or a locally connected 
55 printer 217. 

[0995] As used herein a lightweight component 230, sometimes called a thin client, is software, which, upon execu- 
tion, is able to provide input to and receive output from a runtime environment component, e.g., an application or service 
112 that is sometime called a runtime environment component 112. Lightweight component 230 is tiny enough to be 
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downloaded from first computer system 100 onto second comjauter system 102i via a network 103 and 106 within a 
time significantly smaller than the time required to download the whole runtime environment component 112. 
[0996] In one embodiment, the download time t is particulariy, but not necessarily, defined as 

^ t<(8N/CB) + t^, 

where N is the size of runtime environment component 112 in bytes, Cb is the average bandwidth in bits per second 
of the network connection between first computer system 100 and second computer system 102i, and t^ is the time 
10 needed to initialize runtime environment component 112 in its respective local environment on first computer system 
100. In toda/s commonly available network connections between servers and clients, time t is typically be about ten 
seconds. 

[0997] When using networks commonly used at present for the connection of clients and servers, this time condition 
gives a lightweight component 230. which is - measured in necessary storage space - less than ten or even less 
15 thanfive percent of the scope of the totality of the runtime environment components 120, which can be requested by 
lightweight component 230, including any auxiliary software programs which these mntime environment components 
need to be executed in first computer system 100. 

[0998] Correspondence of lightweight component 230 with runtime environment component 1 1 2 means, in this con- 
text, that lightweight component 230 must offer the second computer system 102i access to the runtime environment 

20 component service made available by component 112. If a plurality of runtime environment component services 120 
is made available by the lightweight component 230, which will frequently be the case, lightweight component 230, in 
this embodiment, corresponds to this plurality of runtime environment component services in the explained sense, 
[0999] Hence, in this embodiment, the software system includes two parts, a first part 230 executed on a client device 
102i, and a second part 120 residing and executed on server computer system 100. Second part 120 on server 100 

25 makes up the runtime environment, which, in this embodiment, comprises a plurality of runtime environment compo- 
nents, which are able to provide services. Furthermore, second part 120 on server computer system 100 provides the 
necessary communication tools in order to communicate with client device 102i. sometimes called user device 102i. 
[1 000] The other part 230. being executed on client device 1 02i, performs communication between client device 1 02i 
in requesting a runtime environment component service being executed on server 1 00. The server's part of the software 

30 system is by far larger in size than the client's part thereof This latter part is refen-ed to as lightweight component 230. 
A typical size of the software system's part 120 on server computer system 100 may be 50 to 100 Megabyte, e.g., an 
office software package, whereas lightweight component 230 on client device 102i has a typical size of 400 Kilobyte, 
and uses minimal system resources (CPU power, memory). 

[1001] Lightweight component 230 provides an application-programming interface (API) for any application program 
35 the implementation of which on client device 102i is allowed by an implementation framework on server computer 
system 1 00. Various types of lightweight components 230 are possible. In one embodiment, the lightweight component 
accesses a particular functionality, e.g.. a mathematical calculator on server 100, which provides a specific result to 
user device 102i for use. In another embodiment, lightweight component 230 handles visual functionality. 
[1002] Hence, in more general terms, runtime environment component services are presented by a first computer 
40 system 100 to a second computer system 102i over a communication network 103/106. Upon receiving a request for 
a mntime environment component service transmitted by second computer system 102i over communication network 
103/106, first computer system 100 executes a runtime environment component 112 for producing a result according 
to the received request, and transmits, over network 1 03/1 06. a response comprising the result to the second computer 
system 102i. 

45 [1003] Herein, computer software programs and parts thereof, which are called during execution of a lightweight 
component 230, are herein refen-ed to as runtime environment components 120. The functionality provided by runtime 
environment components 120 to lightweight component 230 are herein referred to as runtime environment component 
services. The size of runtime environment components 120 renders a distribution over Internet 106 difficult. Runtime 
environment components 120 may be implemented in any suitable form. Runtime environment components 120 may 

50 consist of compiled software program code to be executed or of script code in any programming language to be inter- 
preted before execution by a compiler. Runtime environment components 120 are typically stored and administrated 
on server computer system 100. 

[1 004] Lightweight component 230 makes runtime environment component services, that means the functionalities 
provided by runtime environment components 120, available for use without integrating components 120 into light- 
55 weight component 230 and without distributing components 120 together with lightweight component 230 to the place 
of execution of lightweight component 230, for example, client device 102i. 

[1005] Further, the full functionality of the runtime environment components 120 is available for alt kinds of client 
devices independent of whether the client devices are powerful enough to store or to execute a runtime environment 
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component 112. Further, the user of a client device is not charged with the problem of whether a specific runtime 
environment component 112 is available on client device 102i. 

[1 006] The holding, maintaining and administrating runtime environment components 1 20. as well as executing runt- 
ime environment components 120, is placed on first computer system 100. Nevertheless, second computer system 
1 02i can profit from these runtime environment component services as if the corresponding runtime environment com- 
ponents 120 were present locally on second computer system 102i. Therefore, additional functionality is provided even 
to those computer systems, which are not powerful enough to store and / or execute the full range of runtime environ- 
ment components 120, as for example notebooks, handheld computers, organizers and mobile telephones. 
[1007] Figure 3 is a process flow diagram for one embodiment of method 300 of this invention. Initially, a user of 
device 1 02i issues a request to use applications 1 20 over network 1 03/1 06 to web server 111. The transmission of the 
request over the network 103/106 is performed according to a predetermined transmission protocol. In response to 
the request from user device 102i, web server 112 determines in lightweight component available check operation 301 
whether the request was from lightweight component 230. If the request was from lightweight component 230, process- 
ing transfers to login operation 310 and othenvise to device capability check operation 302 

[1 008] Device capability check operation 302 determines whether user device 1 021 can execute and use lightweight 
component 230, e.g., is there a lightweight component 230 available for the general type of user device 102i, and is 
the operating system, processor, and memory of specific user device 102i sufficient to execute and support lightweight 
component 230. This information may be included in the initial request, a process on server computer system 100 may 
communicate with user device 102i to obtain the information, or altematively, the request may include an identifier that 
is used to access a database to determine the capabilities of user device 102i. 

[1009] If user device 1021 is capable of executing and supporting lightweight component 230, processing transfers 
to download component operation 304 and otherwise to retum error operation 303. Return error operation 303 sends 
an appropriate en-or message to user device 1 02i to infomi the user of the incompatibility between requested application 
112 and user device 102i. 

[1 010] Download component operation 304 downloads, and installs if necessary, lightweight component 230 on user 
device 102i. Thus, prior to starting login operation 310, lightweight component 230 is available on user device 1021. 
[1011] In response to the request to access applications 120, in login operation 310, a connection is established 
over network 103/106 to a daemon executing on server 112. The daemon returns a handle to a daemon service factory 
to lightweight component 230. 

[1012] Upon receipt of the handle to the daemon service factory, lightweight component 230 issues a request to the 
service factory to initiate execution of a login service on server computer system 100. Upon activation of the login 
service, lightweight component 230 transmits a user identification, a password, and options for runtime environment 
components 120 to the login service. The login service on server 100 validates the user login in login operation 310 
and transfers to initialize application operation 320. 

[1013] Start application operation 322 within operation 320 activates a service factory for runtime environment com- 
ponents 120 on server 100 and returns a handle to this service factory to lightweight component 230. Operation 322 
transfers processing to create user interface operation 326 within initialize application operation 320. 
[1 014] In create user interface operation 326, lightweight component 230 issues a request to the runtime environment 
components service factory to start an infrastructure generation service. In response to the request, the service factory, 
executing on server computer system 100, activates the infrastructure generation service, and returns a handle to this 
service to lightweight component 230. Processing transfers to create visual infrastructure operation 327. 
[1015] In operation 327, lightweight component 230 issues a request to start the infrastructure generation service, 
and passes a handle to a client factory to the service. Lightweight component 230 next issues a request to create a 
visual infrastructure on server computer system 100 for processing the visual portion of the user interface. 
[1016] In response to the request from lightweight component, 230, the infrastructure generation service first issues 
a request to the client factory on user device 102i to create a remote frame window, and then this service creates a 
corresponding server window object on server computer system 100. The server window object queries the remote 
frame window on user device 102i to determine the fonts, display parameters, etc. on user device 102i. Altematively, 
the server window object can obtain identifier information from user device 1 021 and then use this identifier information 
to access a database that includes the display capabilities of device 102i. Upon completion of the queries, operation 
327 transfers to create environment infrastructure operation 328. 

[1 017] In operation 328, the infrastmcture generation service creates a frame object that controls the environment 
of the server window object and creates a direct connection between the frame object and lightweight component 230. 
Operation 328 transfers to run application operation 330. 

[1 01 8] In mn application operation 330, lightweight component 230 sends a command to the frame object to load a 
particular document in application 1 1 2. In response, the frame object initializes application 1 1 2 and loads the document 
in application 112. 

[1 019] Application 112 reads the loaded document, and generates a display layout that is sent to the server window 
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object. In turn, the server window object sends the display layout to the remote frame window In lightweight component 
230. The remote frame window generates commands to a device dependant graphic layer, e.g., the JAVA AWT, which 
in turn generates the user interface on display screen 295 of monitor 216, in this embodiment. 
[1020] If user device 1021 has limited Input/output capability, the user may be able to only read the document, or 
perhaps direct the document to a local output device if application 112 includes such a capability, e.g., a capability to 
write to a local printer or to write to a fax printer. If as in Figure 2 . user device 1 021 includes multiple input/output devices, 
the user can utilize the full functionality of application 102i. For example. If the user utilizes mouse 218 to scroll down 
in the document. The scroll action is interpreted by the windowing environment on user device 102i and a scroll com- 
mand Is set by the windowing environment to the remote window frame of lightweight component 230. 
[1 021] The remote window frame, in tum, sends a scroll command over network 103/1 06 to the sender window object 
on server 100. The server window object processes the event received and generates an application event that in tum 
is processed by application 112. In this example, application does a re-layout based on the scrolling, and redraws the 
display in the server window object that in tum sends a redraw command to the remote frame window on user device 
102i. 

[1 022] In one embodiment, the transmissions over network 1 03/1 06 between lightweight component 230 and server 
100 are encrypted according to known technologies. Further, in another embodiment, digital signatures are used to 
provide certification of the request mechanism being established on the client for this runtime environment component 
services system. 

[1 023] The size of a lightweight component 230 does not increase with the number of accessed runtime environment 
components of the implementation sender framework. This infroduces the ability to offer runtime environment compo- 
nents, which expose only sen^ices designed for a special purpose and hide the complexity of the implementation 
framework. 

[1024] In one embodiment of the invention, the STAROFFICE application suite is utilized as runtime environment 
components 120 on server computer system. Figure 4 is an illustration of a layer architecture of the STAROFFICE 
application suite used in this embodiment. 

[1 025] System abstraction layer 401 encapsulates all system specific APIs and provides a consistent object-oriented 
API to access system resources in a platform independent manner. All platform dependent implementation is below 
this layer, or is part of optional modules. To reduce the porting effort, the functionality provided by system abstraction 
layer 401 is reduced to a minima set available on every platform. Also, for some systems, layer 401 includes some 
implementations to emulate some functionality or behavior. For example on systems where no native multi threading 
is supported, layer 401 can support so called "user land" threads. 

[1 026] The operating system layer (OSL) within layer 401 encapsulates all the operating system specific functionality 
for using and accessing system specific resources like files, memory, sockets, pipes, etc. The OSL is a very thin layer 
with an object oriented API. 

[1027] The runtime library within layer 401 provides all semi platform independent functionality. There is an imple- 
mentation for string classes provided. Routines for conversion of strings to different character sets are implemented. 
The memory management functionality resides in this module. 

[1 028] As a generic container library with layer 401, the standard template library is used. This library supplies im- 
plemerttations for list, queues, stacks, maps, etc. 

[1029J The remote visual class library (VCL) is shown as bridging infrastructure layer 402 and system abstraction 
layer 402. Remote VCL receives all user interface events and sends responses to user interface events over network 
to lightweight component 230 on another computer, which then displays the actual output as described above. Remote 
VCL encapsulates all access to the different undertying GUI systems on different client devices. Remote VCL is a high 
level definition of a graphic device defined as a set of interfaces. Remote VCL is based completely on a component 
infrastructure. This gives remote VCL the ability to map functionality, which a client system is unable to support, to a 
service component on the server side emulating this functionality. 

[1 030] The implementation of remote VCL is platfomn independent and includes an object oriented 2D graphics API 
with metafiles, fonts, raster operations and the whole widget set use by the STAROFFICE application suite. This ap- 
proach virtually guarantees that all widgets have the same behavior independently of the used GUI system on the 
different platforms. Also the look & feel and the functionality of the widgets are on all platfomis the same. Remote VCL 
includes a mapping to the interface of the lightweight component that is described more completely below. Since this 
mapping is platform independent, remote VCL does not access any native window system. 

[1 031 ] Infrastructure layer 402 is a platform independent environment for building application, components and serv- 
ices. Layer 402 covers many aspects of an object oriented API for a complete object oriented platform including a 
component model, scripting, compound documents, etc. 

[1 032] To make the usage of system resources like files, threads, sockets, etc. more convenient the virtual operating 
system layer encapsulates all the functionality of the operating system layer into C++ classes. The tools libraries are 
different small libraries building up a set of tool functionality. This includes a common implementation for handling date 
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and time related data. There is an implementation for structured storages available. Other Implementations provide a 
generic registry, typesafe management and persistence of property data. 

[1033] Universal network objects are a component technology that does not depend on any graphical subsystem, 
but are heavily based on multithreading and network communication capabilities. The system consists of several pieces. 

5 An IDL-Compiler, which generates out of the specified definition of an interface a binary representation and the asso- 
ciated C- Header or JAVA technology files. The binary representation is platfomn and language independent and is at 
runtime used to marshal arguments for remote function calls or to generate code on the fly for a specific language to 
access the Implementation provided by the interface. Many parts of the UNO technology are implemented as UNO 
components. This helps to create a very flexible system and also the extension of the system at runtime. For example. 

10 by providing new bridges or communication protocols, UNO provides transparent access to components over the 
network or locally For a more complete description of bridges, see CHAPTER B. For the communication over the 
network. HOP can be used. If the components are realized as shared libraries, the components can be loaded into to 
the process memory of the application and every access of the component is just like a function call without any 
marshalling of arguments which is required for remote function calls. 

15 [1 0341 The Universal Content Broker (UCB) allows all upper layers to access different kind of stmcture content trans- 
parently The UCB includes a core and several Universal Content Providers, which are used to integrate different 
access protocols. One implementation provides content providers for the HTTP protocol. FTP protocol, WebDAV pro- 
tocol and access to the local file system. 

[1 035] The UCB not only provides access to the content, but also the UCB provides the associated meta infomnation 
20 to the content. Actually, synchronous and asynchronous modes for operations are supported. A more complete de- 
scription of the UCB is provided in CHAPTER A. 

[1036] Framewortc layer 403 allows the reuse of implementations in different applications. Layer 403 provides the 
framework or environment for each application and all shared functionality like common dialogs, file access or the 
configuration management 

25 [1 037] The application framework library in layer 403 provides an environment for all applications. All functionality 
shared by all applications and not provided by any other layer is realized here. For the framewortc every visual appli- 
cation has to provide a shell and can provide several views. The library provides all basic functionality so only the 
application specific features have to be added. 

[1038] The application framework library is also responsible for content detection and aggregation. The template 
30 management is provided here and the configuration management too. The application framewortc library is in some 
areas related to the compound documents, because of the functionality for merging or switching menu- and toolbars. 
Also, the library provides the capability for customization of all applications. 

[1 039] The SVX library in layer 403 provides shared functionality for all applications, which is not related to a frame- 
wortc. So part of the library is a complete object oriented drawing layer, which is used by several applications for graphic 

35 editing and output Also a complete 3D-rendering system is part of the drawing functionality. The common dialogs for 
font selection, color chooser, etc. are all part of this library. Also the whole database connectivity is realized here. 
[1040] All applications are part of application layer 404. The way these applications interact is based on the lower 
layers. All applications like the word processor application, spreadsheet application, presentation application, charting 
application, etc. build up this layer. All these applications are realized as shared libraries, which are loaded by the 

40 application framewortc at runtime. The framewortc provides the environment for all these applications and also provides 
the functionality for how these applications can interact. 

[1 041] In one embodiment, the user interface library is implemented using native compiled computer code using the 
visual class library (VCL) that encapsulates all access to the GUI system on user device 230 by application 112 that 
is executing on server computer system 100. In another embodiment, the user interface library that includes the VCL 

45 functionality is implemented in the JAVA programming language. 

[1 042] Figures 5A to 5D are a sequence diagram for one embodiment 'the present invention. Along the horizontal 
axis are individual objects, where each object is represented as a labeled rectangle. For convenience, only the objects 
needed to explain the operation are included in each Figure. The vertical axis represents the passage of time from top 
to bottom of the page. Horizontal lines represent the passing of messages between objects. A dashed line extends 

50 down from each rectangle, and a rectangle along the dashed line represents the lifetime of the object. Moreover, 
brackets are used to show which objects exist on client device 1021 and which objects exist on server 100. 
[1 043] In one embodiment, lightweight component 230 is embedded in a graphical environment that includes a dis- 
play software program with a graphical user interface (GUI). The graphical user interface is refen-ed to as a panel. An 
example of one implementation is a Java bean, which is embedded in an HTML page and rendered by a browser. This 

55 Java bean represents a view (in a window) of an office application component (e.g. STAROFFICE Writer) or another 
visual office component. In this environment, the user is using a browser on user device 102i that utilizes the JAVA 
Abstract Window Toolkit (AWT). In another embodiment, a native C-programming language plug-in is used in the brows- 
er on user device 1021 to implement this invention. As is known to those of skill.in the art. the AWT is a set of JAVA 
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classes and interfaces that are mapped to a concrete implementation on each different platform. The sequence dis- 
played in Figures 5A to 5D is for a JAVA-enabled system. 

[1 044] When the user requests an application on the sen/er, a JAVA bean, an object StarBean 511 . is instantiated. 
Object StarBean 511 automatically issues a call to a method connect in the API of an object connection 512. The call 

5 to method connect includes a URL to sender 100 on which application suite 120 is located. 

[1 045] In response to the call to method connect, object connection 512 calls method connect in object connector 
513. In this embodiment server 100 runs a daemon process 520, sometimes called daemon 520 that includes an 
object ServiceFactory 521 that accepts Internet I nter-OrB Protocol (HOP) connections. In response to the call to method 
connect, connector object 51 3 makes a connection with daemon process 520 on server 1 00 and stores a handle object 

10 ServiceFactory 521 of daemon 520. 

[1 046] Upon completion of the connection to daemon process 520, connection object 512 calls method getFactory 
f Daemon") in the API of object connector 513 to obtain the handle for object ServiceFactory 521 . 
[1047] Next, object StarBean 511 calls method login in the API of object Connection 512 with a user identification, 
a password, and options for application suite 120 on server 100, which in this embodiment is the STAROFFICE suite 

15 of components. In response to the call to method login, object Connection 512 calls method createlnstance in the API 
of object ServiceFactory 521 of daemon 520, and specifies that an instance of the login service is needed. 
[1 048) Object ServiceFactory 521 instantiates object LoginService 522 by calling method activate in the API of object 
LoginService 522. Object ServiceFactory 521 retums a handle to object LpginService 522 to object connection 512. 
[1049] Object connection 512 calls method login of object LoginSenflce 522 with the user identification, password, 

20 and options. In response to the login call, object LoginService 522 mns method validateLogin to validate the login 
request. If the login request is valid, object LoginService 522 starts application suite 120 as a new process on server 
1 00 with the rights of the user with userlD. Object LoginSennce 522 calls method activate of the API of object Serv- 
iceFactory 531 to instantiate object ServiceFactory 531. 

[1 050] Finally, to proceed with creating the infrastmcture needed for application suite 1 20 and lightweight component 
25 230 to work together, object connection 512, sometimes called connection object 512, calls method getFactory in object 
connector with an argument "Application* to get the handle to object ServiceFactory 521 that in tum is stored in object 
Connection 512. Upon activation of object ServiceFactory 531 and retum of its handle to object Connection 512, a 
connection is established between application suite 120 and lightweight component 230 so ttiat the application suite 
120 and lightweight component 230 can communicate directiy ovier network 103/106. 
30 [1 051] Upon object Connection 51 2 reluming processing to object StarBean 511 , object StarBean 511 calls method 
getObjectf BeanService") in the API of object Connection 512. In method getObject. connection object 512 calls method 
createlnstancef BeanService'') (Fig. 5B) in object ServiceFactory 531 and in tum object ServiceFactory 531 instantiates 
object BeanService 532 by calling method activate in the API of object BeanService 532. A handle to object BeanService 

532 is returned to object StarBean 511 and is stored by object StarBean 511 . 

35 [1 052] Next, object StarBean 51 1 calls method start in the API of object BeanService 532. A handle to object Client- 
Factory 515 is passed in the call to method start so that application suite 120 can create windows and any other 
components on client device 102i needed by application suite 120. 

[1053] To create the infrastructure needed to run application suite 120 on server 100, object StarBean 512 calls 
method createBeanWindow of object BeanService 532. Object BeanService 532 then calls metiiod createlnstance 
40 ("RmFramewindow") in the API of object ClientFactory 515 and object ClientFactory 515 initializes remote frame win- 
dow object 514 on user device 1 02i. 

[1054] Following creation of remote frame window object 514 on user device 102i, object BeanService 532 calls 
initialize method init(RmFrameWindow) to create an instance of object BeanWindow 534 to support remote frame 
window object 514. To further initialize object BeanWindow 534, object BeanWindow 534 sends one or more queries 

45 to object. RmFrameWindow 514 to detemnine the display capabilities of user device 1021. 

[1 055] Finally, object BeanService 532 calls method init(Wlndow) to instantiate and initialize object BeanFrame 533 
for application suite 120. Object BeanFrame 533 controls the environment for this instance of application suite 120.. 
For example, object BeanFrame 533 conti-ols the lifetime of components of the user interface on client device 1021 
used by application suite 120, the loading of such components, and so on. A handle to object BeanFrame 533 is 

50 returned to and stored by object StarBean 511 . 

[1056] Upon receiving the handle to object BeanFrame 533. object StarBean 511 calls method loadDocument(uri) 
in the API of object BeanFrame 533 (Fig. 5C), Here, url is an address, e.g. , a uniform resource locator, of the document 
requested by the user Object BeanFrame 553 can determine which component is requested in a numiier of ways. For 
example, object BeanFrame 533 can ask the underiying transport component for a content type, or perhaps look at 

55 the first few bytes of an available number As a last resort, the extension of the address is used by object BeanFrame 

533 to determine which component within application suite 120 to launch. Independent of ttie technique used to Identify 
the requested runtime environment component, after identifying the component in this emt)odiment, object BeanFrame 

. 533 calls method init(Window) in component StarWriter 535 in the STAROFFICE application suite. 
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[10571 this embodiment, the component initialized by BeanFrame 533 must use the remote VCL and only It to 
handle user interface input/output However, no other modifications are required to work in this environment Any prior 
art application that works in a windowing graphic user interface could be used in place of component StarWriter so 
. along as it included the functionality provided by the remote VCL and used only that functionality to handle user interface 
5 input/output. 

[1 058] After component StarWriter 535 is initialized, object BeanFrame 533 calls method load(url) in the API of com- 
ponent StarWriter 535. Component StarWriter 535 loads the document at the address specified in method load and 
performs methods readDocument and do Layout Upon completing the window layout, component StarWriter calls 
method show in the API of object BeanWindow.534, and in response, object BeanWindow 534 calls method show in 
10 the API of object RemoteFrameWindow 514. Object RemoteFrameWindow 51 4 causes the window generated by com- 
ponent StarWriter 535 to be displayed on display screen 295 of user device 102i. 

[1 0S9J Similariy. as the user of user device 1 02i perfomns an input action on the information displayed, the appropriate 
input event is transmitted from object RmFrameWindow 514 to object BeanWindow 533 and in turn to component 
StarWriter 535. Conversely, each call to a method in the graphic user interface, e.g.. method drawUne, method draw- 
is Text, etc., is made to the API of object BeanWindow 533 and a con-esponding method call is made to a method in the 
API of object RmFrameWindow 514 by object BeanWindow 533. 

[1060] Figure 5D is an example of the processing of a mouse click by the user. In this example, the mouse click 
event is handled by the AWT panel, which in tum calls method onMouseClick(x,y) of object RmFrameWindow 514. 
Remote frame window object 514, in response, calls method MouseEvent(x,y) of object BeanWindow 534. 
20 [1 061] Object BeanWindow 534 runs method processUlevent to determine the particular event that occurred, and 
calls an appropriate method in the API of component StarWriter 535. In this example, object BeanWindow 534 calls 
method applicationEvent(ButtonClicked) in the API of component StarWriter 535. 

[1 062] In response to the method call, component StarWriter 535 runs methods processApplicationEvent, re-layout, 
and re-draw. Method re-draw calls the appropriate methods in object BeanWindow 534 that in turns issues correspond- 

25 ing method caljs to object RmFrameWindow. 

[1 063] In the embodiment of Figures 5A to 5D, objects 531 to 534 are an example of a user interface infrastructure 
that receives graphic user interface events from user device 102i. and that the runtime environment component service 
sends remote graphic user interface commands. Here, commands are the calls to the various methods in the interfaces 
of the objects. A local command is one on system 100. A remote input action command is a command sent from 

30 lightweight component 230 on user device 102i to the user interface infrastructure on system 100 in response to a user 
input A remote output command is a command sent by the user interface infrastructure on system 100 to lightweight 
component 230 on user device 102i. Similariy, object BeanFrame 533 is an example of a local frame object, and object 
BeanWindow 534 is an example of a local window object. Thus, objects and actions on system 100 are considered 
local, while objects and actions on user device 1021 are considered remote. 

35 [1 064] Figure 6 is one embodiment of a class diagram for the sequence diagram of Figures 5A to 5D. Figures 7, 8A 
to 80, 9, IDA and 10B illustrate one embodiment of interfaces, structures, enumerations and exceptions associated 
with each interface illustrated in Figure 6 and give a corresponding Table number for each in the description that follows. 
The names of elements, e.g., interfaces, structures, exceptions, enumerations, strings, constants, etc., are indicative 
of the nature of the particular element. 

40 [1065] In this embodiment of the invention, remote frame window class RmFrameWindow (Figure 6) includes a 
remote frame window interface XRmFrameWmdow (Table 1 ) and a remote output device interface XRmOutputDevice 
(Table 8). Interface XRmFrameWmdow inherits from interface XInterface (Table 2 and Fig. 7) and uses interface 
XEventHdl (Table 4). Interface XRmFrameWindow, in the embodiment of Table 1, includes methods Create, Re- 
leaseWindow, SetTitle, Show, SetClientSize, GetClientSize, SetWIndowState, GetFontResolution, GetFrameResolu- 

45 tions, ToTop, StartPresentation, SetAlwaysOnTop, ShowFul I Screen, CaptureMouse, SetPointer, SetPointerPos, Beep. 
GetKeyNames, Enable, Setlcon, SetMinClientSize, Mouse MoveProcessed, and KeylnputProcessed. (Herein, an ital- 
icized phrase and the same phase that is not italicized are the same phrase.) 

[1 066] Method ReleaseWindow notifies the client, that the window connected to this interface is not needed by the 
server anymore. Whether the real window is destroyed and a new one created on the next call of Create or the real 
50 window is cached is up to the client implementation. 
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TABLE 112.: Interface XFmFrameWindow 



typedef sequence< IDLKeyNamelnfOr 1 > KeyNameSequence; 

interface XRmFrameWindow : 

com: :sun: :star: :uno: :XInterface 

{ 

[oneway] void Create ( [in] unsigned long nWinBits, 
[in] XEventHdl xEvent Interface, [in] any 
aSystemWorkWindowToken, [in] XRmFrame Window 
xParent ) ; 

[oneway] void ReleaseWindow ( ) ; 

[oneway] void SetTitle{ [in] string rTitle ); 

(oneway] void Show( [in] boolean bVisible ); 

[oneway] void SetClientSize ( [in] short nWidth, [in] 
short nHeight ) ; 

void GetClientSize ( [out] short rWidth, [out] short 
rHeight ) ; 

string GetWindowState ( ) ; 

[oneway] void SetWindowState ( [in] string aState ); 
void GetFontResolution( [out] long nDPIX, [out] long 
nDPIY ) ; 

RmFrameResolutions GetFrameResolutions () ; 

[oneway] void ToTop( [in] unsigned short nFlags ); 

[oneway] void StartPresentation ( [in] boolean 

bStart, [in], unsigned short nStartFlags ) ; 
[oneway] void SetAlwaysOnTop ( [in] boolean bOnTop ); 
[oneway] void ShowFullScreen ( [in] boolean bFullScreen) ; 
[oneway] void CaptureMouse ( [in] boolean bMouse ); 
[oneway] void SetPointer( [in] unsigned short 

ePointerStyle ) ; 
[oneway] void Set PointerPos ( [in] short nX, [in] short 

nY ) ; 

[oneway] void Beep( [in] unsigned short eSoundType ); 
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void GetKeyNames { [out] KeyNameSequence rKeyNames ); 
[oneway] void Enable ( [in] boolean bEnable ); 
[oneway] void SetIcon( [in] short IconID ); 
[oneway] void SetMinClientSize ( [in] short Width, [in] 
short Height ) ; 

[oneway] void MouseMoveProcessed ( ) ; 



Interface X/nferfec© (Table 2) is the base interface for other interfaces and provides lifetime control by reference count- 
ing. Interface Xtnterface also provides the possibility of querying for other interfaces of the same logical object. Logical 
object in this case means that the interfaces actually can be supported by internal, i.e., aggregated, physical objects. 
25 [1067] Method Q(yery/nte^ce//)interfaceX/nfe^cequeriesfora new interface to an existing object. Method acQU/re 
increases a reference counter by one, while method release decreases the reference counter by one. When the ref- 
erence counter reaches a value of zero, the object is deleted. 



15 



[oneway] void 
}; 



KeylnputProcessed { ) ; 
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TABLE 113.: INTERFACE XInterface 



35 




interface XInterface 



40 



45 



50 



55 



219 



EP1 126 681 A2 



// 

/** queries for a new interface to an existing 
object . 

@param aUik 

specifies the Uik of the interface to 
be queried. 

@parara ifc 

returns the new interface if the method 
succeeds. 

@returns 

<TRUE/> if the UNO object to which this 
interface referred supports the 
interface denoted by parameter aUik- 

. */ 

any querylnterf ace ( [in] type aType ); 

//boolean querylnterf ace ( [in] 
//com: :sun: rstar: :uno: :Uik aUik, 
// [out ] any ifc ) ; 

// 

/** increases the reference counter by one. 

(oneway] void acquire (); 

// 

/** decreases the reference counter by one. 

When the reference counter reaches 0, the object 

gets deleted. 

*/ 

(oneway] void release (); 



220 



EP1 126 681 A2 

}; 



068] One embodiment of structure Uik in interface XInterface is presented in Table 3. 

TABLE 114.: Structure Uik 



/** specifies a universal interface key. 

An UIK is an unambiguous 16-byte value for every 
interface. 
*/ 

struct Uik 
{ 

// 

// specifies a 4 byte data block, 
unsigned long m_Datal; 

// 

/// specifies a 2 byte data block, 
unsigned short m_Data2; 

// 

/// specifies a 2 byte data block, 
unsigned short m Data3; 
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// . 

/// specifies a 4 byte data block, 
unsigned long m_Data4; 



10 



II 



15 



11/ specifies a 4 byte data block, 
unsigned long m_Data5; 



20 



//= = = = = = = = = = = =: = = = = = = = = = = = === = ==== = ^ = ===== = ===== === 



25 " — ' " 

[1 069] Methcxl Create in interface XRmFrameWindow of class RmFrameWindow (Fig. 6) includes as an input a 
reference to an event handler interface XEventHdl (Table 4), Class BeanWindow (Fig. 6) also uses event handler 
interface XEventHdl. In this embodiment, Interface XEventHdl inherits from interface Xlnterface (Table 2) and uses a 
30 Structure KmDropFileEvent (Table 5). Interface XEventHdl includes methods MouseButtonUp, MouseButttonDown, 
Mouseiy/love, Mouse Wheel, Keylnput, KeyUp, Paint, Resize, GetFocus, LoseFocus, Close, Query DropFile, DropFile, 
and UserEvent. 

[1070] One embodiment of structure Rm DropFile Event that is passed in the call to method RmDropFileEvent is 
presented in Table 5. 

35 
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TABLE 115.: INTERFACE XEventHdl 



interface XEventHdl : com: : sun: : star : :uno: rXInter face 
{ 

[oneway] void MouseButtonUp ( [in] short nX, [in] short 
nY, (in] unsigned short nMode, [in] unsigned short 
nCode, [in] unsigned long nSysTime ); 

[oneway] void MouseButtonDown ( [in] short nX, [in] 

short nY, [in] unsigned short nMode, [in] unsigned 
short nCode, [in] unsigned long nSysTime ) ; 

[oneway] void MouseMove ( [in] short nX, [in] short nY, 
[in] unsigned short nMode, [in] unsigned short 
nCode, [in] unsigned long nSysTime ); 

[oneway] void MouseWheeK [in] long nX, [in] long nY, 
[in] unsigned short nCode, [in] unsigned long 
nSysTime , [in] long nDelta, [in] long 
nNotchDelta, [in] unsigned long nScrollLines, [in] 
boolean bHorz) ; 

[oneway] void Keylnput ( [in] unsigned short nKeyCode, 
[in] unsigned short nChar, [in] unsigned short 
nCount ) ; 

[oneway] ' void KeyUp( [in] unsigned short nKeyCode, 

[in] unsigned short nChar ); 
[oneway] void Paint ( [in] long nX, [in] long. nY, [in] 

long nWidth, [in] long nHeight ); 
[oneway] void Resize ( [in] short nWidth, [in] short 

nHeight ) ; 
[oneway] void GetFocusO; 
[oneway] void LoseFocusO; 
boolean QueryDropFile ( [inout] 

RmDropFileEvent rDropFileEvent ) ; 
boolean DropFile( [in] RmDropFileEvent 

aDropFileEvent ) ; 
[oneway] void Close (); 
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[oneway] void UserEvent ( [in] unsigned long EventlD, 
[in] any Parameter ) ; 

}; 



TABLE 116. Structure RmDropFileEvent 



typedef sequence< string > FileNameSequence; 



struct RmDropFileEvent 

{ 

short 
short 

FileNameSequence 
unsigned short 
unsigned short 
byte 
boolean 

}; 



nX; 
nY; 

aFileNameSequence ; 
nDropAction; 
nSourceOptions; 
nWindowType; 

bIsDefault ; 



[1 071] structures used in interface XRmFrameWindow (Table 1 and Fig. 7) include stmcture RmFrameResolutions 
(Table 6) and structure IDLKeyNamelnfo (Table 7). 
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TABLE 117,: Structure RmFrameResolutions 



struct RmFrameResolutions 
{ 

long DPIx; 
long DPIy; 
long FontDPIx; 
long FontDPIy; 
unsigned short Depth; 

); 



TABLE 118 Structure IDLKeyNamelnfo 



struct IDLKeyNamelnfo 
{ 

unsigned short nCode; 
string aName; 



[1 072] As illustrated in Fig. 6, class RmFrameWindow indudes remote output device interface XRmOutputDmice 
(Table 8). \r\XeTi^ce XRmOutputDevice inherits from interface X/nfe/^ce (Table 2). and uses structures IDLFontMetric- 
Data, KemPair, IDLFontData, IDLFont (Table 9). In the embodiment of Table 8, interface XR/nOutpafDev/ce Indudes 
methods QuerySvOutputDevicePtr. SetClip Region, ResetClipRegion. GetResolution. GetCharWidth, GetFontMetric, 
GetKemPairs, GetDevFontList, AddFontAtom. GetGlyph Bound Rect, GetGlyphOutline, GetPixel. GetPixelArray, Set- 
Font. SietTextColor, SetLineColor, SetFillColor/SetRasterOp, CopyArea, Copy Bits, Invert, InvertPolygon, InvertTrack- 
ing, I nvertTracking Polygon, DrawPixel, DrawColored Pixel, DrawPixelArray, DrawLine, DrawRect. DrawPolyLine, 
DrawPolygon, DrawPolyPolygon, DrawEllipse, DrawArc, DrawPie, DrawCord, DrawGradient, DrawPolyPolyGradient, 
DrawPolyPolyHatch, DrawText, DrawTextArray, DrawWaveLine. DrawGrid, DrawPolyPolyTransparent, and 
Draw2ColorFrame. 
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TABLE 119. : Interface XRmOutputDevice 



interface XRmOutputDevice : 

com: :sun: :star: :uno: :XInterface 

{ 

unsigned long QuerySvOutputDevicePtr ( ) ; 
[oneway] void SetCIipRegion ( [in] ByteSequence aData 
) ; 

[oneway] void ResetClipRegion ( ) ; 

void GetResolution ( [out] long nDPIX, [out] long 
nDPIY, [out] unsigned short nBitCount ) ; 

sequence< long > GetCharWidth { [in] unsigned short 
nStart, [in] unsigned short nEnd ); 

void GetFontMetric ( [out] IDLFontMetricData 

rFontMetric, [in] unsigned short nFirstChar, [in] 
unsigned short nLastCar, [in] boolean 
bCetKernPairs ) ; 

sequence< KernPair > GetKernPairs ( ) ; 

void GetDevFontList ( [out] sequence< string > 
FontNameAtoms, [out] sequence< string > 
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StyleNameAtoms, [out] IDLFontDataSequence 
rFontData ) ; 

[oneway] void AddFontAtom( [in] byte Type, [in] string 

Name, [in] unsigned short Atom ); 
boolean GetGlyphBoundRect { [in] unsigned short cChar, 

[out] long nX, [out] long nY, [out] long nWidth, 

[out] long nHeight, [in] boolean bOptirnize ); 
boolean GetGiyphOutline ( [in] unsigned short cChar, 

[out] ByteSequence rPoly, [in] boolean bOptimize 

) ; 

void GetPixeK [in] long nX, [in] long nY, [out] 

unsigned long nColor ) ; 
void GetPixelArray ( [in] ByteSequence aData, [out] 

ULongSequence aColors ) ; 
[oneway] void SetFont ( [in] IDLFont aFont ); 
(oneway] void SetTextColor ( [in] unsigned long nColor 

) ; 

[oneway] void SetLineColor ( [in] unsigned long nColor 
) ; 

[oneway] void SetFillColor { [in] unsigned long nColor 
) ; 

[oneway] void SetRasterOp( [in] unsigned short nROP ); 
[oneway] void CopyArea ( [in] long nSrcX, [in] long 

nSrcY, [in] long nSrcWidth, [in] long 

nSrcHeight, [in] long nDestX, [in] long nDestY, 

[in] unsigned short nFlags ) ; 
[oneway] void CopyBits ( [in] long nSrcX, [in] long 

nSrcY, [in] long nSrcWidth, [in] long nSrcHeight, 

[in] long nDestX, [in] long nDestY, [in] long 

nDestWidth, [in] long nDestHeight, [in] 

XRmOutputDevice xFrom ) ; 
[oneway] void Invert ( [in] long nX, [in] long nY, [in] 

long nWidth, [in] long nHeight, [in] unsigned 

short nFlags ) ; 
[oneway] void InvertPolygon ( [in] ByteSequence 

aPolygon, [in] unsigned short nFlags ) ; 
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(oneway] void InvertTracking ( [in] long nX, [in] long 

nY, [in] long nWidth, [in] long nHeight, [in] 

unsigned short nFlags ) ; 
[oneway] void InvertTrackingPolygon ( [in] ByteSequence 

aPolygon, [in] unsigned short nFlags ); 
[oneway] void DrawPixel ( [in] long nX, [in] long nY ); 
[oneway] void DrawColoredPixel ( [in] long nX, [in] 

long nY, [in] unsigned long nColor ); 
[oneway] void DrawPixelArray ( [in] . ByteSequence aData, 

[in] ULongSequence aColors ); 
[oneway] void DrawLine{ [in] long nStartX, [in] long 

nStartY, [in] long nEndX, [in] long nEndY ); 
[oneway] void DrawRect ( [in] long nX, [in] long nY, 

[in] long nWidth, [in] long nHeight ); 
[oneway] void DrawPolyLine ( [in] ByteSequence aData ); 
[oneway] void DrawPolygon( [in] ByteSequence aData ); 
[oneway] void DrawPolyPolygon ( [in] ByteSequence aData 

) ; 

[oneway] void DrawRoundedRect ( [in] long nX, [in] long 
nY, [in] long nWidth, [in] long nHeight, [in] 
unsigned long nHorzRound, [in] unsigned long 
nVertRound ) ; 

[oneway] void DrawEllipse( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight ); 

[oneway] void DrawArc( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 

[oneway] void DrawPie ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 

[oneway] void DrawChord{ [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 
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(oneway] void DrawGradient ( [in] long nX, [in] long 

nY, [in] long nWidth, [in] long nHeight, [in] 

ByteSequence aData ) ; 
(oneway] void DrawPolyPolyGradient ( [in] ByteSequence 

aPolyPolyData, [in] ByteSequence aGradientData ); 
(oneway] void DrawPolyPolyHatch ( [in] ByteSequence 

aPolyPolyData, [in] ByteSequence aHatchData ); 
[oneway] void DrawText { [in] long nX, [in] long nY, 

[in] string aText ); 
[oneway] void DrawTextArray ( [in] long nX, [in] long 

nY, [in] string aText, [in] LongSequence aLongs ); 
(oneway] void DrawWaveLine ( [in] long nStartX, [in] 

long nStartY, [in] long nEndX, [in] long nEndY, 

[in] unsigned short nStyle ); 
[oneway] void DrawGrid( [in] long nMinX, [in] long 

nMaxX, [in] sequence< long > aHorzValues, [in] 

long nMinY, [in] long nMaxY, [in] sequence< long 

> aVertValues, [in] unsigned long nFlags ); 
[oneway] void DrawPolyPolyTransparent ( [in] 

ByteSequence aData, (in) unsigned short 

nTransparencyPercent ) ; 
[oneway] void Draw2ColorFrame ( [in] long x, [in] long 

y, [in] unsigned long width, [in] unsigned long 

height, [in] unsigned long lef tAndTopColor, [in] 

unsigned long rightAndBottomColor ) ; 

}; 



[1 073] In one embodiment, method GetFontMetric (Table 8) gets the general metrics of the current font. If the value 
of inputs nFirstChar and nLastChar are not equal, member maCharWidths of output stmcture IDLFontMetrlcData (Table 
9) is filled as it would be in a call by method GetCharWidth and so saves one synchronous call. If the Boolean input 
value of variable bGetKemPairs Is true, member maKemingPairs of output structure IDLFontMetricData is filled as it 
would be in a call to method GetKem Pairs, and this saves another synchronous call. 

[1 0741 *n method AddFontAtom, Type is a FontAtomType; Name is the new atom string; and Atom the new atomic 
value 

[1 075] In Table 9, a brief description of given of the values in the various structures. 
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TABLE 120. Structure and Other Information Used 
by Interface XRmOutputDevice 



// [in] Eingabe-Parameter . Der "Server" auf dem das 
Object liegt // ist der Remote-Client. 
// Also "Server" eigentlich "Display" 

// [oneway] => Kein warten auf Antwort 



struct KernPair 
{ 

unsigned short Charl; 
unsigned short Char2; 
short Kerning; 

}; . 

struct IDLFontMetricData 
{ 

// these data must be set 

// Durchschnittsbreite vom Font in Pixeln (must same as 
by Set Font) 

short mnWidth; 
// Ascent 
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short 



mnAscent ; 



// Descent 



short 



run Descent ; 



// Internal-Leading 



short 



mnLeading; 



// Schraegsteliung (bei Italic) 



// Erstes druckbare Zeichen im Font 

unsigned short mnFirstChar ; 

// Letztes druckbare Zeichen im Font 

unsigned short mnLastChar ; 

// this data should be overwritten 

// Font name: Atom 

unsigned short mnNaine; 

// Stylename: Atom 

unsigned short mnStyleName; 

// Rotation 

short mnOrientation; 

// Family vom Font 

byte meFamily; 

// CharSet vom Font 

byte meCharSet; 

// Weight vom Font 

byte meWeight; 

// Italic vom Font 

byte meltalic; 

// Pitch vom Font 

byte mePitch; 

// Type vom Font 

byte meType; , 

// 1st es ein Device-Font 

boolean mbDevice; 

// factor for charwidths 

long mnFactor; 

sequence< long > maCharWidths; 

sequence< KernPair > maKerningPairs 



short 



mnSlant; 
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In- 



struct IDLFontData 
{ 

// Struktur zum Abfragen der DevFontList 

// Name vom Font: Atom 

unsigned short mnName; 

// StyleName vom Font: Atom 

unsigned short mnStyleName; 

// Breite vom Font in Pixeln 

short mnWidth; 

// Hebehe vom Font in Pixeln 

short mnHeight; 

// Family vom Font 

byte meFamily; 

// CharSet vom Font 

byte meCharSet; 

// Pitch vom Font 

byte mePitch; 

// WidthType vom Font 

byte meWidthType; 

// Weight vom Font 

byte meWeight; 

// Italic vom Font 

byte meltalic; 

// Type vom Font 

byte meType; 

// bitO: mborientation 

//bit 1: mbDevice 

byte mnBools; 



}; 



struct IDLFont 
{ 

// Struktur zum Setzen eines Fonts.. 
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unsigned short 
unsigned short 
short 



mnName; 



mnStyleName; 



byte 
byte 
byte 
byte 
byte 
byte 
short 



short 



mnWidth; 
rtinHeight ; 
meFamily; 
meCharSet; 



meWidthType; 



me Weight; 
meltalic; 



mePitch; 
mnOrientation; 



}; 



typedef sequence< byte, 1 > ByteSequence; 



typedef sequence< long, 1 > LongSequence; 

typedef sequence< unsigned long, 1 > ULongSequence; 

typedef sequence< unsigned short . 1 > UShortSequence; 

typedef sequence< IDLFontData, 1 > IDLFontDataSequence; 

constants FontAtomType 
{ 

const byte NAME = 0; 
const byte STYLE = 1; 

}; 



[1 076] In Figure 6, class ClientFactory includes interface XMultilnstanceFactory (Table 1 0 and Fig. 7). Class Client- 
Factory is called by an object BeanFrame to generate multiple instances of class RmFrameWmdow. Interface XMulti- 
lnstanceFactory inherits from interface XInterface (Table 2). 



233 



EP1 126 681 A2 

TABLE 121- : INTERFACE XMultilnstanceFactory 



interface XMultilnstanceFactory : 

com: :sun: :star: :uno: :XInterface 



{ 



sequence<any> createlnstances ( 
[in] string aObjectName, 
[in] long nCount) ; 



}; 



[1077] In Figure 6, class ServiceFactory include interface XMultiServiceFactory (Table 11 and Fig. 7). Class Serv- 
iceFactory is called by an object connector to generate objects LoginService and BeanService. Interface XMultiServ- 
iceFactory inherits from interface X/nferfece (Table 2) and throws an exception Exception (Table 12). 

TABLE 122.: INTERFACE XMultiServiceFactory 



interface XMultiServiceFactory: 

com: : sun: : star: :uno: :XInterface 

{ 

com: :sun: :star: :uno: :XInterface createlnstance ( [in] 
string aServiceSpecif ier ) 
raises ( com: :sun: :star: :uno: :Exception ); 
com: :sun: :star: :uno: :XInterface 

createlnstanceWithArguments ( 

[in] string ServiceSpecif ier, 
[in] sequence<any> Arguments ) 
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10 



15 



20 



25 



raises ( com: : sun; : star: :uno: : Exception ) ; 
sequence<string> getAvailableServiceNames ( ) ; 
}; 



[1 078] The service factory objects support this interface for creating components by a specifying string, i.e. the service 
name. In the embodiment of Table 11, interface XMultiServiceFactory includes methods createlnstance. createln- 
stanceWithArguments. and getAvailableServiceNames. 

[1079] Method createlnstance creates an instance of a component which supports the services specified by the 
factory. Input parameter ServiceSpecifier is a service name that specifies the service that should be created by this 
factory. 

[1 080] Method createlnstanceWithArguments creates an instance of a component which supports the services spec- 
ified by the factory. Input parameter aArguments is the values of the arguments that depend on the service specification 
of the factory. Normally the factory delegates the arguments to the method init() of the created instance. The factory 
is explicitly allowed to modify, delete or add arguments. The conversion rules of the arguments are specified by a 
converter service. Input parameter ServiceSpecifier is a service name that specifies the service that should be created 
by this factory. 

[1 081] Method getAvailableiServiceNames returns a sequence of all service identifiers, which can be instantiated. 
[1 082] Table 1 2 presents one embodiment of exception Exception that is used by interface XMultiServiceFactory. 



TABLE 123.: EXCEPTION Exception 



30 



35 



40 



exception Exception 
{ 

string Message; 

com: : sun: : star: :uno: iXInterface Context ; 
}; 



45 



50 



[1 083] In this embodiment, exception Exception is the basic exception from which all other exceptions are derived. 
Parameter Message specifies a detailed message of the exception or an empty string if the callee does not describe 
the exception. Context is an object that describes the reason for the exception. Object Context may be NULL if the 
callee does not describe the exception. 

[1 084] Service LoginService that is instantiated by object ServiceFactory of the daemon includes an interface XLogin 
(Table 13 and Fig. 7). Interface XLog/n inherits from iriterface X/nferfece and uses an enumeration Resuitof Login. 

TABLE 124.: INTERFACE XLogin 



55 



enum Resuitof Login 
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{ 

OK, 

NO_LICENSE, 

ALREADY_LOGGED_IN , 

SECURITY_VIOLATION; 

COULD_NOT_TO_FILESERVER, 

NO^CONFIGURATION, 

UNKNOWN_ERROR 

}; 

interface XLogin: com: :sun: :star: :uno: iXInterface 
{ 

Boolean installationHasBeenCompleted ( [in) string 

sNameOf User ) ; 
void completelnstallation ( [in] string sNameOfUser, 

[in] string sPassword ); 
ResultofLogin login ( [in] string sNameOf User , [in] 

string sPassword, [in] string sNameOfWorlcstation, 

[in] string sParameter lu- 
string getQualif iedNameOfUser ( [in] string 

sNameOfUser ) ; 

}; 



[1085] in the embodiment of Table 13, interface XLogin includes methods installationHasBeenCompleted, com- 
pletelnstallation, login, and getQuallfiedNameOfUser 

[1 086] Class BeanService includes an interface XRmStarOffice in the embodiment of Figure 6. One embodiment of 
interface XRmSfarOffice is presented in Table 14. Interface XRmSfarOffice inherits from interface Xlnterface and uses 
interfaces XMt//WSemceFacfofy (Table 11) and XRmFrameWindow (Table 1). See Figure 7. 
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TABLE 125. : INTERFACE XRmStarOf f ice 



typedef enum _StartUpError { 

SOFFICE_NO_ERROR, 

SO FFICE_WRONG_LOG IN, 

SOFFICE_SERVICE_NOT_FOUND, 

SOFFICE_C0NNECTI0N_REFUSED, 

SOFFICE_NO_LICENSE, 

SOFFICE_UNKNOWN_ERROR, 

SOFFICE_ALREADY_STARTED 
} StartUpError; 

constants StarOf f iceServerType 
{ 

const long APPSERVER = 0; 

const long BEANSERVER =1; 
const long ONESERVER = 2; 

}; 

interface XRmStarOf f ice : 

com: : sun: : star: :uno: :XInterface 

I 

/** AppName+Params+Version+Language;. weil ueber den 
Demon dann spaeter auch andere Programme gestartet 
werden koennen... 

StartUpError Start ( 

[in] com: :sun: :star: :lang: :XMultiServiceFactory 

xClient Factory, 
[in] string aConnectionName/ 
[in] string aUserName, 
[in] string aPassword, 
[in] string aFileServer, 
[in] string aClientSystemName, 
[in] string aAppName, 
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[in] string aAppParams, 
[in] unsigned long nAppLanguage, 
[in] unsigned long nRemoteVersion, 
[in] long servertype 

) ; 

[oneway] void SetUserInf oForPrinting ( 
[in] string AuserName, 
[in] string aPassword ); 
void AddRemotePrinter { 

[in] string aNamS/ 

[in] string aServer, 

[in] boolean bSetAsDef ault , 

[in] boolean bIsLocal ) ; 
com: :sun: :star: :uno: iXInterface CreateBeanWindow ( 

[in] XRmFrameWindow xFrameWin, 

[in] com: : sun: : star: : lang: rXMultiServiceFactory 

xCl lent Factory, 
[in] any aSystemWindowToJcen ) ; 

}; 



[1087] In the embodiment of Table 14, interface XRmStarOffice Includes methods Start, SetUserlnfoForPrinting. 
AddRemotePrinter, and CreateBeanWindow. Method start receives as input a reference to object ClientFactory, a user 
name, a password, identification of a file server, and a specification of the application that is to be started, e.g., param- 
eters application name, application parameters, application language, and version. Method CreateBeanWindow re- 
ceives a reference to object RmFrameWindow, and object ClientFactory as inputs. 

[1 088] Class BeanFrame (Fig. 6) includes two interfaces, interface XFrame (Table 15) and Interface XDispatchPro- 
wder{Table62 and Fig. 9). Intheembodimentof Table 15, interface XFrame inherits from interface XComponenf (Table 
16). Interface XFrame uses interfaces XVWnc/ow (Table 19), XConfro//er (Table 53 and Fig. SC),an6XFmmeActionUs- 
tener (Table 59 and Fig. 8C). As illustrated in Figures 8A to 8C, each of these interfaces uses other interfaces, structures, 
exceptions, and enumerations that are described more completely below. 

[1 089] In the embodiment of Table 1 5, interface XFrame includes methods Initialize, setCreator, getCreator, getlMame, 
setName, findFrame, isTop, activate, deactivate, setComponent, getComponentWindow, getController, contextCh- 
anged, add FrameAction Listener, and removeFrameAction Listener 
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TABLE 126.: INTERFACE XFRAME 



interface XFrame: com: rsun: :star: :lang: rXComponent 
{ 

void initialize { [in] com: : sun: : star :: awt :: XWindow 
xWindow ) ; 

com: :'sun: :star: rawt: : XWindow getContainerWindow () ; 

[oneway] void setCreator( 

[in] XFramesSupplier xCreator ); 

[const] XFramesSupplier getCreator { ) ; 

[const] string getNameO; 



239 



EP 1 126 681 A2 



[oneway] void setName ( [in] string aName ); 

com: : sun :: star :: frame : iXFrame f indFrame ( [in] string 
aTargetFrameName, [in] long nSearchFlags ) ; 

boolean isTopO ; 

[oneway] void activate (); 

[oneway] void deactivate () ; 

boolean isActive(); 

boolean setCpmponent ( [in] com; :sun: :star: :awt: iXWindow 
xComponent Window, [in] 

com: :sun: :star : :.frame: rXCont roller xCont roller ) ; 
[const] com: :sun: :star: rawt: rXWindow 

getComponentWindow () ; 
[const] XController getController ( ) ; 
void contextChanged ( ) ; 
[oneway] ^ void addFrameActionListener ( 

[in]XFrameActionListener xListener ); 
[oneway] void removeFrameActionListener ( [in] 

XFrameActionListener xListener ) ; 

}; 



[1 090] Interface XFrame makes it possible to control a frame. Method initialize is called to initialize the frame within 
a window. Method getContainerWindow provides access to the window of the frame. Nomially this is used as the parent 
window of the controller window. Method setCreator sets the frame container that created this frame. Only the creator 
is allowed to call method setCreator. Method getCreator retums the frame container that created this frame. Method 
getName retums the programmatic name of this frame. Method setName sets the name of the frame. Normally, the 
name of the frame is set initially. 

[1 091] Method findFrame searches for a frame with the specified name. Frames may contain other frames, e.g., a 
frameset, and may be contained in otherframes. This hierarchy is searched with this method. First some special names 
are taken into account, i.e. "".".self , ".top", "_active" etc., flag nSearchFlags is ignored when comparing these names 
with parameter aTargetFrameName, and further steps are controlled by flag nSearchFlags. If allowed, the name of the 
frame itself is compared with the desired one, then (again, if allowed )the method is called for all children of the frame. 
Finally the method may be called for the parent frame (if allowed). If no frame with the given name is found, a new top 
frame is created if this is not suppressed by a special value of flag FrameSearchFlag. The new frame also gets the 
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desired name. 

[1092] Method isTop determines if the frame is a top frame. In general, a top frame is the frame >A^ich is a direct 
child of a task frame or which does not have a parent. If a frame retums for this method, all calls have to stop the 
search at such a frame unless the flag FrameSearchFlag::TASKS is set. 

[1 093] Method activate activates this frame and thus the component within. At first, the frame sets itself as the active 
frame of its creator by calling Frame Action:: FRAME. ACTIVATED. The component within this frame may listen to this 
event to grab the focus on activation. For simple components, this can be done by a Frame Loader. Finally, most frames 
may grab the focus to one of its windows or forward the activation to a sub-frame. 

[1 094] Method deactivate is called by the creator frame when another sub-frame is activated. At first the frame de- 
activates its active sub-frame, if any, and then broadcasts a Frame Action Event with FrameAction:: 
FRAME.DEACTIVATING. 

[1095] Method isActive detemiines if the frame is active. Method setComponent sets a new component into the 
frame. Method getComponentWindow retums the current visible component in this frame. The frame is the owner of 
the window. Method getConfroller retums the current controller within this frame. Nomnally, it Is set by a frame loader 
[1 096] Method contextChanged notifies the frame that the context of the controller within this frame changed (i.e. 
the selection). According to a call to this interface, the frame calls with FrameAction: :CONTEXT_CHANGED to all 
listeners, which are registered using this frame. For external confrollers, this event can be used to requery dispatches. 
[1097J Method addFrameActionUstener registers an event listener, which is called when certain things happen to 
the components within this frame or within sub-frames of this frame. For example, it Is possible to determine instanti- 
ation/destruction and acti vation/deactlvation of components. Method removeFrameActionListener unregisters an event 
listener, which was registered with addFrameActionLlstenerQ. 

[1 098] Interface XFrame Inherits from interface XComponent One embodiment of interface XComponent Is present- 
ed in Table 16, Interface XComponent inherits from Interface XInterface (Table 2) and uses Interface XEventListener 
that In turn uses structure EventObject See Figure 8A. 



TABLE 127.: INTERFACE XComponent 



interface XComponent: com: :sun: :star: :uno: : XInterface 
{ 

void dispose ( ) ; 

void addEventListener ( [in] XEventListener xListener ); 
void removeEventListener ( 

[in] XEventListener aListener ) ; 

}; 



[1 099] Interface XComponent controls the lifetime of components. Actually the real lifetime of an object is controlled 
by references kept on interfaces of the object. There are two distinct meanings in keeping a reference to an interface: 
first is to own the object; and second is to know the object. 

[1 1 00] To prevent cyclic references from resulting in failure to destroy an object, references of interfaces to the object 
are allowed only (i) by the owner, (ii) If the reference is very temporary, or (III) you are registered as an Event Listener 
at that object and cleared the reference when "disposing" is called. 

[1101] An owner of an object calls method dispose to dispose of the object. Only the owner of the object calls method 
dispose if the object should be destroyed. All objects and components must release the references to the objects. If 
the object Is a broadcaster, ail listeners are removed and me\ho6 XEventListener ::disposingO is called on all listeners. 
[1 102] Due to the importance of the concept of method XComponent::dispose(), a figurative example is provided. 
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Imagine there was a hole in the flcx>r and some people around it were holding a box (our component). Everyone who 
holds the box for a longer time than just temporarily (i.e. to put something In or get something out) has to watch a tight 
bulb, which Is attached to the box (listening to event XEventUstener-disposingO)- Now, when the owner of the box 
switched the light on (calling method XComponent::dispose()), everybody holding the box had to take their hands off 
(clear the interface handles). If and only if everyone did that, did the box fall (getting deleted). However, only the owner 
is allowed to switch the light on! After method dispose is called, the Instance has to throw exception Disposed Exception 
for all non-event-method calls and event-method calls have to be ignored. 
[1 1 03] The following is an example of one embodiment, void disposeQ 

{ 

// make a copy 

Listener [] aTmpListeners = MyListeners . clone () ; 

// clear all listeners (against recursion) 
MyListeners . clear (.) ; 

// call all listeners 

EventObject aEvt = new EventObject () ; 
aEvt.xSource = this; 

for{ i = 0; i & It; aTmpListeners. length; i++ 

aTmpListeners [i] . disposing ( aEvt ); 

} 

[1 104] Method addEventListener adds an event listener to the listener list for the object. The broadcaster fires the 
disposing method of this listener if method dispose() is called. Conversely, method removeEventListener removes an 
event listener from the listener list for the object. 

[1 1 05] As described above, interface XComponent uses interface XEventListener (Table 17.) 



TABLE 128.: INTERFACE XEventListener 



interface XEventListener: 

com: :sun: :star: :uno: rXInterface 

{ 

void disposing ( (in) com: :sun: :star: :lang: : EventObject 
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Source ) ; 

}; 



[1 106] Interface XEventUstener (Table 17) inherits from interface XInterface (Table 2). Interface XEventUstener is 
a tagging Interface that all event listener interfaces must extend. Method disposing is called when the broadcaster is 
about to be disposed. All listeners and all other objects, which reference the broadcaster should release the references. 
One embodiment of stmcture EventObject is presented in Table 18. 



TABLE 129.: Structure EventObject 



struct EventObject 
{ 

com: :sun: : star: :uno: :XInterface Source; 

}; 



[1 1 07] Structure EventObject specifies the base for all event objects and identifies the source of the event. Field 
Source refers to the object that fired the event 

[1 1 08] As explained above, interface XWmdow (T able 1 9) is used by interface XFrame (Table 1 5). See also Fig. 8A. 
In the embodiment of Table 19, interface XWindow inherits from interface XComponenf (Table 16) and uses interfaces 
XWindowListener (Table 21), XFocusListener (Table 23), XKeyListener (Table 25), XMouseListener (Table 28), 
XMouseMotionListener (Table 30), and XFa/nfL/sfener (Table 31), and structure Rectangle (Table 20), each of which 
is described herein. 
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TABLE 130.: INTERFACE XWindow 



interface XWindow: com: :sun: :star: :lang: rXComponent 
{ 

[oneway) void setPosSi2e( [in] long X, [in] long Y, 
[in] long Width, [in] long Height, [in] short 
Flags ) ; 

[const] com: :sun: :star: :awt: : Rectangle getPosSizeO ; 
[oneway] void setVisible( [in] boolean Visible ); 
[oneway] void setEnable( [in] boolean Enable ); 
[oneway] void set Focus (); 
[oneway] void addWindowListener ( [in] 

com: : sun: : star : :awt : : XWindowListener xListener ) ; 
[oneway] void removeWindowListener ( [in] 

com: : sun: : star: :awt : : XWindowListener xListener ) ; 
[oneway] void addFocusListener ( [in] 

com: : sun: : star: :awt: : XFocusListener xListener ) ; 
[oneway] void removeFocusListener ( [in] 

com: :sun: :star: :.awt; : XFocusListener xListener ) ; 
[oneway] void addKeyListener ( [in] 

com: ; sun: : star : :awt: :XKeyListener xListener ); 
[oneway] void removeKeyListener ( [in] 

com: : sun: : star : :awt: :XKeyListener xListener ); 
[oneway] void addMouseListener ( [in] 

com : : sun : : star : : awt : : XMouseListener xListener ) ; 
[oneway] void removeMouseListener ( [in] 

com: : sun: : star :: awt : :XMouseListener xListener ); 
[oneway] void addMouseMotionListener ( [in] 

com: : sun: : star: : awt : :XMouseMotionListener 
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xListener ) ; 
[oneway] void removeMouseMotionListener ( [in] 

com: : sun: : star : : awt : iXMouseMotionListener 

xListener ) ; 
[oneway] void addPaintListener ( [in] 

com: :sun: :star: :awt: :XPaintListener xListener ); 

[oneway] void removePaintListener ( [in] 

com: :sun: : star : :awt: rXPaintListener xListener ); 

}; 



[1 1 09] Interface XWmdow (Table 19) specifies the basic operations for a window component. A window is a rectan- 
gular region on an output device with a position, size, and internal coordinate system. The main sense of a window is 
to receive events from the user. 

[1110] Method setPosSize sets the outer bounds of the window. Method getPosSize returns the outer bounds of the 
window. Method setVisible shows or hides the window depending on the parameter. Method setEnable enables or 
disables the window depending on the parameter. Method setFocus sets the focus to the window. Method addWin- 
dowLlstener adds the specified component listener to receive component events from this window component. Method 
removeWindowListener removes the specified listener so it no longer receives component events from this window 
component. Method addFocusListener adds the specified focus listener to receive focus events from this window com- 
ponent. Method removeFocus Listener removes the specified focus listener so it no longer receives focus events from 
this component. Method addKeyUstener adds the specified key listener to receive key events from this component. 
Method removeKeyListener removes the specified key listener so it no longer receives key events from this component. 
Method addMouseListener adds the specified mouse listener to receive mouse events from this component. Method 
removeMouseListener removes the specified mouse listener so it no longer receives mouse events from this compo- 
nent. Method addMouseMotionListener adds the specified mouse motion listener to receive mouse motion events from 
this component. Method removeMouseMotionListener removes the specified mouse motion listener so it no longer 
receives mouse motion events from this component. Method addPaintListener adds the specified paint listener to 
receive paint events from this component. Method removePaintListener removes the specified paint listener so It no 
longer receives paint events from this component. 

[11111 Structure Rectangle (Table 20) specifies a rectangular area by position and size. Field Y specifies the y- 
coordinate. Field Width specifies the width. Field Height specifies the height. 
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TABLE: 131.: STRUCTURE Rectangle 



struct Rectangle 
{ 

long X; 
long Y; 
long Width; 
long Height; 
}; 



[1112] An embodiment of interface XWindowUstener that Is used in the above embodiment of interface XWindow 
(Table 19) is presented in Table 21 . Interface XWindowUstener inherits from interface XEventListener (Table 17) and 
uses structure WindowEvent (Table 22.) 

25 

TABLE 132.: INTERFACE XWindowListener 



interface XWindowListener : 

com: : sun: : star: ilang: : XEventListener 

I 

[oneway] void windowResized( [in] 

com : : sun : : star : : awt : : WindowEvent e } ; 
[oneway] void windowMoved( [in] 

com: :sun: :star: :awt: : WindowEvent e ) ; 
[oneway] void windowShown ( [in] 

com: :sun: :star: :lang: :EventObject e ) ; 
[oneway] void windowHidden ( [in] 

com: : sun : : star : : lang : : EventObject e ) ; 

}; 



55 [1113] I nterface XWindowUstener makes it possible to receive window events. Component events are provided only 
for notification purposes. Moves and resizes are handled internally by the window component, so that the GUI layout 
works properly independent of whether a program registers such a listener. Method windowResized is invoked when 
the window has been resized. Method windowMoved is invoked when the window has been moved. Method window- 
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Shown is invoked when the window has been shown. Method windowHidden is invoked when the window has been 
hidden. 

[1114] One emk)Odiment of stmcture WindowEvent used in Table 21 is presented in Table 22. 



TABLE 133. 



STRUCTURE WindowEvent 



10 



20 



25 



30 



Struct WindowEvent: com: :sun: :star: :lang: :EventObject 
{ 



long 


X; 


long 


Y; 


long 


Widths- 


long 


Height; 


long 


Leftlnset ; 


long 


Toplnset ; 


long 


Rightlnset ; 


long 


Bottomlnset ; 


}; 





35 



40 



45 



50 



[1115] Structure WindowEvent specifies the component-level keyboard event and inherits from structure EventObject 
(Table 18). Field X specifies the outer X-position of the window. Field Y specifies the outer Y-position of the window. 
Field Width specifies the outer (total) width of the window. Field Height specifies the outer (total) height of the window. 
Field Leftlnset specifies the inset from the left. The Inset is the distance between the outer and the inner window, in 
other words in this case it is the width of the left border Field Toplnset specifies the inset from the top. The inset is the 
distance between the outer and the inner window, in other words in this case it is the height of the top border. Field 
Rightlnset specifies the inset from the right. The inset is the distance between the outer and the inner window, in other 
words in this case it is the width of the right border. Field Bottomlnset specifies the inset from the bottom. The inset is 
the distance between the outer and the inner window, in other words in this case it is the height of the bottom border. 
[1116] An embodiment of interface XFocusListener thai is used in the above embodiment of interface XWindow 
(Table 19) is presented in Table 23. interface XFocusL/sfener inherits from interface XEventUstener (Table 17) and 
uses structure Focus Event (Table 24.) 



55 



247 



EP 1 126 681 A2 

TABLE 134.: INTERFACE XFocusListener 



10 



15 



20 



interface XFocusListener: 

com: : sun : : star: : lang : rXEventListener 

{ 

[oneway] void focusGained( [in] 

com : : sun : ; star : : awt : : FocusEvent e ) ; 

[oneway] void focusLost( [in] 

com: : sun: : star: : awt :: FocusEvent e ); 

}; 



[1117] Interface XFocusListener makes it possible to receive keyboard focus events. The window, which has the 
25 keyboard focus, is the window, which gets the keyboard events. Method focusGained is invoked when a window gains 
the keyboard focus. Method focusLost is invoked when a window loses the keyboard focus. 
[1118] One embodiment of structure FocusEvent used in Table 23 is presented in Table 24. 



30 



TABLE 135, 



STRUCTURE FocusEvent 



35 



40 



45 



struct FocusEvent: com: ; sun: : star: : lang: :EventObject 
{ 

short FocusFlags; 

com: : sun: : star: :uno: :XInterface NextFocus; 

boolean Temporary; 

}; 
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[1119] structure FocusEvent specifies a keyboard focus event, and Inherits from structure EventObject (Table 18). 
There are two levels of focus change events: permanent and temporary. Permanent focus change events occur when 
focus is directly moved from one component to another, such as through calls to method requestFocus() or as the user 
uses the Tab key to traverse connponents. Temporary focus change events occur when focus Is gained or lost for a 
component as the indirect result of another operation, such as window deactivation or a scrollbar drag. In this case, 
the original focus state is automatically restored once that operation is finished, or for the case of window deactivation, 
when the window is reactivated. Both permanent and temporary focus events are delivered using the FOCUS_GAI NED 
and FOCUS_LOST event ids; the levels may be distinguished In the event using the method isTemporary{) 
[1 120] Field FocusFlags specifies the reason for the focus change as an arithmetic, or combination of FocusChang- 
eReason. Field NextFocus contains the window which gets the focus on a lose focus event. Field Temporary specifies 
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if this focus change event is a temporary change. 

[11211 An embodiment of interface XKeyUstener that is used in the at>ove embodiment of interface XWindow (Table 
1 9) is presented in Table 25. 1 nterfaceXKeyUsfener inherits from interface XEvenfUsfe/ier (Table 1 7) and uses structure 
KeyEvent (Table 24.) that in turn inherits from structure InputEvent (Table 27), 

TABLE 136.: INTERFACE XKeyListener 



interface XKeyListener: 

com: :sun: :star: :lang: :XEventListener 

I 

(oneway] void JceyPressed( [in] 

com: : sun: : star: :awt: : KeyEvent e ); 

[oneway] void keyReleased{ [in] 

com: :sun: :star: :awt: : KeyEvent e ) ; 

}; 



[1 122] Interface XKeyUstener makes it possible to receive keyboard events. Method keyPressed is invoked when 
a key has been pressed. Method keyReleased is invoked when a key has been released. 

[1 123] The embodiment of structure KeyEvent in Table 26 inherits from structure InputEvent (Table 27), as described 
above. Structure KeyEvent specifies the component-level keyboard event. Field KeyCode contains the integer code 
representing the key of the event. This is a constant from the constant group Key Field KeyChar contains the Unicode 
character generated by this event or 0. Field KeyFunc contains the function type of the key event. This is a constant 
from the constant group KeyFunction. 



TABLE 137.: STRUCTURE KeyEvent 



struct: KeyEvent : com: : sun : : star : rawt : : InputEvent 
{ 

short KeyCode; 
char KeyChar; 
short KeyFunc; 



(1 124] Structure InputEvent is the root event class for all component-level input events and inherits from structure 
EventObject (Table 18). Input events are delivered to listeners before they are processed normally by the source where 
they originated. Structure InputEvent contains the modifier keys, which were pressed while the event occun-ed, i.e., 
zero or more constants from the KeyModifier group. 
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TABLE 138.: STRUCTURE InputEvent 



10 



struct InputEvent: com: :sun: :star: : lang: :EventObject 



15 



short Modifiers; 



20 



[11 25] An embodiment of interface XMouseUstener that is used in the above embodiment of interface XWindow 
(Table 19) Is presented in Table 28. Interface XMouseUstener inherits from interface XEventListener (Table 17) and 
uses structure MouseEvent (Table 29,) that In turn inherits from structure InputEvent (Table 27). 



25 



TABLE 139.: INTERFACE. ;fMouseListener 



30 


{ 

[oneway] 


void 


mousePressed ( [in] 








com: 


: sun 


: : star : : awt : : MouseEvent 


e 


) ; 


35 


[oneway] 


void 


mouseReleased ( [in] 








com: 


: sun 


: :star: :awt: : MouseEvent 


e 


) ; 




[oneway] 


void 


mouseEntered ( [in] 








com: 


: sun 


: :star: :awt: : MouseEvent 


e 


) ; 


40 


(oneway] 


void 


mouseExited( [in] 








com: 


: sun 


: :star: :awt : : MouseEvent 


e 


) ; 




}; 










45 













[1 1261 Interface XMouseUstener makes it possible to receive events from the mouse in a certain window. Method 
mousePressed is invoked when a mouse button has been pressed on a window. Method mouseReleased is Invoked 
50 when a mouse button has been released on a window. Mie.thbd mouseEntered is Invoked when the mouse enters a 
window. Method mouseExited is invoked when the mouse exits a window. 

[1 127] The embodiment of structure MouseEvent in Table 29 inherits from stmcture InputEvent (Table 27). 
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TABLE 140.: STRUCTURE MouseEvent 



struct MouseEvent: com: :sun: :star: :awt: :InputEvent 
{ 

short Buttons; 
long X; 
long Y; 

long ClickCount; 
boolean PopupTrigger; 
}; 



[1 1 28] Structure MouseEvent specifies an event from the mouse. Field Buttons contains the pressed mouse buttons, 
which are zero or more constants from the group MouseButton. Field X contains the x coordinate location of the mouse. 
Field Y contains the y coordinate location of the mouse. Field ClickCount contains the number of mouse clicks asso- 
ciated with event. Field PopupTrigger specifies if this event is a popup-menu trigger event. 

[1 1 29] An embodiment of interface XMouseMotionListener that Is used in the above embodiment of interface XWin- 
dow (Table 1 9) is presented in Table 30. Interface XMouseMotionUstenennhenis from interface XEventUstener (Table 
17) and uses structure MouseEvent (Table 29). 

TABLE 141.: INTERFACE XMouseMotionListener 



interface XMouseMotionListener: 

com: : sun: : star: : lang: :XEventListener 

{ 

void mouseDragged ( [in] com: : sun: : star :: awt : :MouseEvent 
e >; 

void mouseMoved( [in] com: :sun: :star: :awt : :MouseEvent e 
) ; 
}; 



[1 130] Interface XMouseMotionListener makes it possible to receive mouse motion events on a window. Method 
mouseDragged is invoked when a mouse button is pressed on a window and then dragged. Mouse drag events continue 
to be delivered to the window where the first event originated until the mouse button Is released independent of whether 
the mouse position Is within the bounds of the window. Method MouseMoved is invoked when the mouse button has 
been moved on a window with no buttons down. 

[1 1 31 1 An embodiment of interface XPaintUstener that is used In the above embodiment of interface XWindow (Table 
19) Is presented in Table 31. Interface XPa/nfL/stener inherits from interface XEvenfUstene/- (Table 17) and usesstruc- 
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ture PaintEvent (Table 32) that inherits from structure EventObject (Jab\e 18) and structure Rectangle {Table 20). See 
Figure 8B. 



TABLE 142.: INTERFACE XPaintListener 



10 



15 



20 



interface XPaintListener: 

com: :sun: :star: :lang: :XEventListener 

{ 

(oneway] void windowPaint ( [in] 

com: : sun: : star : :awt :: PaintEvent e ); 
}; 



25 



[1132] Interface XPaintListener makes it possible to receive paint events. Method WindowPaint is called when a 
region of the window becomes invalid, for example, because another window was moved away. 



TABLE 143.: STRUCTURE PaintEvent 



30 



35 



• 40 



Struct PaintEvent: com: :sun: :star: :lang: : EventObject 
{ 

com: :sun: :star: :awt: : Rectangle UpdateRect; 
short Count; 
}; 



50 



[1 1 33] Structure PaintE\/ent specifies the paint event for a component. This event Is a special type, which is used to 
ensure that paint/update method calls are serialized along with the other events delivered from the event queue. Field 
UpdateRect contains the rectangle area, which needs to be repainted. Field Count contains the number of paint events 
that follows this event If it is a multiple PaintEvent. Paint events can be collected until Count Is zero. 
[1 134] An embodiment of interface XFramesSupplier that Is used In the above embodiment of interface XWindow 
(Table 19) is presented in Table 33. Interface XFramesSupplier inherits from interface XFrame (Table 15) and uses 
Interface XFrames that in turn Inherits from several other interfaces as illustrated in Figure 8B, and uses several struc- 
tures, enumerations, and exceptions. One embodiment of each of these interfaces, structures, enumeration, and ex- 
ceptions are described herein. 
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TABLE 144.: INTERFACE XFrames Supplier 



interface XFramesSupplier : XFrame 
{ 

XFrames get Frames ( ) ; 
[const] XFrame getActiveFrame ( ) ; 
void setActiveFrame ( [in] XFrame xFrame ); 
}; 



[11 35] Methcxi getFrames returns the collection of (sul>-) frames, which is represented by a container FramesCon- 
20 talner. Method getActiveFrame returns the sut)-frame, which is active within this frame. This may be the frame itself. 
The active frame is defined as the frame, which contains (recursively) the window with the focus. If no window within 
the frame contains the focus, this method returns the last frame, which had the focus. If no containing window ever 
had the focus, the first frame within this frame is returned. 

[1 1 36] Method setActive Frame is called on activation of a direct sub-frame. This method is allowed to be called only 
25 by a sub-frame. After this call, the frame specified by input parameter xFrame is returned. In general this method first 
calls the method at the creator frame with this as the current argument. Then it broadcasts the FrameAction Event 
FrameAction::FRAME_ ACTIVATED. 

[1 137] In the embodiment of Table 34, interface XFrames inherits from interface XindexAccess (Table 35). Interface 
XFrames manages and creates frames. Frames may contain other frames by implementing an interface XFrames and 
30 may be contained in other frames. 
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TABLE 145. 



INTERFACE XFrames 
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interface XFrames: 

com: : sun; rstar: -.container: : XindexAccess 

\ 

void append ( 

[in] com: : sun: : star: : frame: rXFrame xFrame ); 
sequence<com: : sun: : star: : frame: :XFrame> queryFrames ( 

[in] long nSearchFlags ) ;' 
void remove ( [in] com: : sun: : star: :frame: : XFrame xFrame 

); 



[1 138] Method append appends the specified Frame to a list of subhframes. Method queryFrames returns all child 
frames of the container, which are intended to be visible to other objects. The content of the sequence may be limited 
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by the caller through the flag FrameSearchFlag. 

[1 1 39] Method remove removes the frame from its container The creator attribute of the frame must be reset by the 
caller of this method. 

[1 1 40] The embodiment of interface XIndexAccess in Table 35 provides access to the elements of a collection through 
5 an index. This Interface should only be used if the data structure itself is indexed. 



TABLE 146.: INTERFACE XIndexAccess 

10 



interface XIndexAccess: 

com: :sun: : star: : container: : XElementAccess 

{ 

[const] long getCountO; 
[const] any getByInclex( [in] long Index ) 
raises ( 

com: :sun: : star: : lang: : IndexOutOf BoundsException, 
com: : sun: : star: : lang: : WrappedTargetException ) ; 



30 [1 141] Method getCount returns the number of elements. Method getBylndex retums the element at the specified 
index. Parameter Index specifies the position in the array. The first index is 0. Method getBylndex throws com::sun:: 
star:lang::lndexOutOfBoundsException (Table 52) if the index is not valid. Method getBylndex throws 
com ::sun::star::lang:: WrappedTargetException (Table 49), if the implementation has internal reasons for exceptions 
that are wrapped In exception WrappedTargetException. 

35 [1 142] In this embodiment, interface XElementAccess is the base interface of all collection interfaces. 



TABLE 147 



INTERFACE XElementAccess 



40 



45 
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interface XElementAccess: 

com: :sun: :star: :uno: rXInterface 

{ 

[const] TYPE_XIDLCLASS getElementType () ; 
[const] boolean hasElements ( ) ; 
}; 



55 



[11 43] Interface XElementAccess inherits from interface XInterface (Table 2). Method getElementType retums the 
type of the elements. Void means that the container is a multi-type container and the exact types with this interface 
cannot be determined with this method. Method hasElements retums <TRUE> if the object contain elements, othenvise 
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<FALSE>. 

[1 144) One embodiment of interface XtdtCtass Is presented in Table 37. Interface XldlCiass provides information 
about a type or module. Every array also belongs to a type that is reflected as an XI dl Class object that is shared by 
all arrays with the same element type and number of dimensions. Rnalty. any of the primitive IDL types are also rep- 
resented as XldlCiass objects. This includes ^'void, any. boolean, char, float, double, octet, short, long, hyper, unsigned 
octet, unsigned short, unsigned long" and "unsigned hyper'. Interface X/{//C/a55 inherits from interfaceX/nfer^ce (Table 
2) 



TABLE 148- : INTERFACE XldlCiass 



interface XldlCiass: com: :sun: :star : :uno: :XInterface 
{ 

sequence<XIdlClass> getClassesO ; 

XldlCiass getClass( [in] string aName ); 

boolean equals ( [in] XldlCiass Type ); 

boolean isAssignableFrom ( [in] XldlCiass xType ); 

com: : sun: : star: : uno: :TypeClass getTypeClass ( ) ; 

string getNameO; 

[const] com: : sun: : star : :uno: : Uik getUi)c(); 
sequence<XIdlClass> getSuperclasses () ; 
sequence<XIdlClass> getlnterf aces ( ) ; 
XldlCiass getComponentType 0 ; 
XldlField getField( [in] string aName ); 
sequence<XIdlField> getFieldsO ; 
XldlMethod getMethod( [in] string aName ); 
sequence<XIdlMethod> getMethods ( ) ; 
XldlArray getArrayO; 
void createObject { [out] any obj ); 
); 



[1 145] Method getCI asses returns all types and modules, which are declared in this class. Method getClass returns 
a type or module with the given name that is declared in this class. Method equals returns <TRUE> if the instances 
describe the same type, otherwise <FALSE>. Method isAssignableFrom tests if the parameter xType is a subclass of 
this class. Method getTypeClass returns the type that this instance represents. Method getName returns the fully qual- 
ified name of the type of object (class, interface, array, sequence, struct, union, enum or primitive) represented by this 
XldlCiass object. Method getUik returns the UIK from this type. If the type has no UIK, the retumed UIK is zero. 
[1 1 46] If this object represents an interface or a class, the objects that represent the superclasses or superinterfaces 
of that class are retumed by method getSuperclasses. If this object is the one that represents the topmost class or 
interface, an empty sequence is retumed. 

[1147] Method getlnterfaces determines the interfaces implemented by the class or interface represented by this 
object. If the dass or interface implements no interfaces, the method returns a sequence of length 0. 
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[11 48] If this class represents an an^y or sequence type, method GetComponentType returns the XldlClass object 
representing the component type of the an^y or sequence; otherwise it returns null. Method getField returns an XldlFleld 
object that reflects the specified member field of the class, interface, struct, union, enum or exception represented by 
this XldlCtass object. If a field with the specified name is not found, 0 is returned. The field to be reflected is located 
5 by searching all the member fields of the dass, interface, struct, union, enum or exception represented by this XldlClass 
object for a field with the specified name or for NULL, if a field with the specified name is not found. Parameter aName 
specifies the simple name of the desired field. 

[1 149] Method getFields returns a sequence containing Field objects reflecting all the accessible fields of the dass. 

interface, struct, union or enum represented by this XldlClass object. Method getFields returns a sequence of length 
10 0 if the dass or Interface has no accessible fields, or if it represents an an-ay. a sequence or a primitive type. Spedfically, 

if this XldlClass object represents a dass. this method returns the fields of this dass and of all its superdasses. If this 

XldlClass object represents an interface, the method returns the fields of this interface and of all its superinterfaces. 

If this XldlClass object represents an array, sequence or primitive type, this method returns a sequence of length 0. 

[1 1 50] Method getMethod returns an XldlMethod object that reflects the spedfied memt»er method of the interface 
IS represented by this XldlClass object. If a method with the spedfied name is not found. "0" is retumed. The method to 

be reflected is located by searching all the member methods of the interface represented by this XldlClass object for 

a method with the spedfied name. Parameter aName specifies the simple name of the desired method. 

[1 1 51] Method getMethods retums a sequence containing XldlMethod objects reflecting all the member methods of 

the class or interface represented by this XldlClass object, including those dedared by the dass or interface and those 
20 inherited from superdasses and superinterfaces. Retums a sequence of length 0 if the class or interface has no member 

methods. 

[1 1 52] Method getArray retums interface XidlArray (Table 50) to get and set the elements by index if the represented 
type is an an^ay or sequence. Method createObject creates an instance of the type represented by this XldlClass object 
If the represented type is a basic type, struct, enum, or sequence. 
25 [1 1 53] Enumeration TypeClass (Table 38) describe all type dasses. which can be defined in the IDL. 
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TABLE 149. : Enumeration TypeClass 



enum TypeClass 
{ 

VOID, 

CHAR, 

BOOLEAN, 

BYTE, 

SHORT, 

UNSIGNED^SHORT, 
LONG, 

UNSIGNED_LONG, 
HYPER, 

UNSIGNED_HYPER, 

FLOAT, 

DOUBLE, 

STRING, 

TYPE, 

ANY, 

ENUM, 

TYPEDEF, 



STRUCT, 

UNION, 

ARRAY, 

INTERFACE, 

SERVICE, 

MODULE, 

INTERFACE_METHOD, 

INTERFACE_ATTRIBUTE, 

UNKNOWN 

}; 
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[11541 Interface XldlFietd (Table 39) Inherits from interface XldlMember (Table 40). 

TABLE 150. : INTERFACE XldlField 



interface XldlField: 

com: : sun: : star: : reflection: : XldlMember 

{ 

com: :sun: :star: : reflection: tXIdlClass getType () ; 
com: :sun: :star: : reflection: : FieldAccessMode 

getAccessMode ( ) ; 
any get ( [in] any obj ) 
raises ( 

com: :sun: : star: : lang: : IllegalArgumentException ) ; 
void set( [in] any obj, [in] any value ) 
raises { 

com: :sun: : star: : lang: : IllegalArgumentException/ 
com: :sun: : star: : lang: : IllegalAccessException ) ; 

}; 



[1 1 551' Method getType returns an XldlClass object that identifies the declared type for the field represented by this 
XldlField object. Method getAccessMode returns an enumeration value, which denotes whether the field is "const**, 
-readonly", "writeonly" or "readwrite". 

[1 1 56] Method get returns the value of the field represented by this field on the spedfied object. The underlying field's 
value is obtained as follows: 

If the underlying field is a constant, the object argument is ignored; it may be NULL; 
[11 57] Otherwise, the underlying field is an instance field. 

[1 158] If the spedfied object argument is NULL, the method throws an "IllegalArgumentException". If the spedfied 
object is not an instance of the class, interface, stmct. union or enum dedaring the underlying field, the method throws 
an "IllegalArgumentException". Othenwise, the value is retrieved from the underlying instance or constant. 
[1 1 59] Method set sets the field represented by this XldlField object on the specified object argument to the spedfied 
new value. The operation proceeds as follows. If the specified object argument is NULL, the method throws an exception 
IllegalArgumentException (Table 42). If the spedfied object argument is not an instance of the dass or interface de- 
claring the underlying field, the method throws an exception IllegalArgumentException. If the underlying field is con- 
stant, the method throws an exception IllegalAccessException (Table 43). If the new value cannot be converted to the 
type of underlying field by an identity or widening conversion, the method throws an IllegalArgumentException. The 
field is set to the possibly widened new value. 

[1 160] Interface XldlMember (Table 40) inherits from interface XInterface (Table 2). Interface XldlMember makes it 
possible to access members of dasses dynamically. 
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TABLE 151.: INTERFACE XldlMember 



interface XldlMember: com: :sun: :star: :uno: :XInterface 
{ 

XldlClass getDeclaringClass 0 ; 
string getName ( ) ; 



[11611 Method getDeclaringClass returns the XldlClass object representing the class, interface, struct, union or enum 
that declares the member represented by this member. Method getName returns the fully qualified name of the type 
(class, interface, array, sequence, struct, union, enum or primitive) represented by this XldlClass object, as a string. 
[1 1 62] The values in enumeration FieldAccessMode (Table 41 ) are used to specify the kind of attribute or property. 



TABLE 152, : Enumeration FieldAccessMode 



enum FieldAccessMode 
{ 
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// 

/** The property is readable and writeable 

READWRITE, 

// 

/** The property is readonly 
*/ 

READONLY, 

// 

/** The property is write only 
*/ 

WRITEONLY, 

// 

/** @deprecated 

*/ 
CONST 

); 



[1163] Exception lllegalArgumentException (Table 42) is thrown to indicate that a method has passed an illegal or 
inappropriate argument. Exception lllegalArgumentException inherits from exception Exception (Table 12). Field Ar- 
gumentPosition identifies the position of the illegal argument. This field is -1 if the position is not known. 

TABLE 153.: EXCEPTION IIIegalArguinen tException 



exception lllegalArgumentException: 
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com: :sun: : star: :uno: .-Exception 

{ 

short ArgumentPosition; 
}; 



[1 1 64] Exception HlegalAccessException (Table 43) is thrown when an application tries to change a constant property. 
Exception tllegalAccessException inherits from exception Exception (Table 1 2). 



TABLE 154.: EXCEPTION HlegalAccessException 



exception HlegalAccessException : 

com: : sun : : star : : uno : : Exception 



{ 



}; 



[1 1 65] Interface XldlMethod (Table 44) inherits from interface XldlMember (Table 40). Interface XldlMember makes 
it possible to access the specification of a method dynamically. 

TABLE 155.: INTERFACE XldlMethod 



interface XldlMethod: 

com: :sun: :star: rreflection: :XIdlMember 

{ 

XldlClass getReturnType 0 ; 
sequence<XIdlClass> getParameterTypes ( ) ; 
sequence<ParamInf o> getParameterlnf os ( ) ; 



261 



EP 1 126 681 A2 



sequence<com: :sun: :star: :reflection: :XIdlClass> 

getExceptionTypes ( ) ; 
com: : sun: :star : : reflection: :MethodMode getMode () ; 
any invoke ( [in] any obj, (inoutj sequence<any> args ) 
raises ( 

com: : sun: : star: : lang: : IllegalArgumentException, 
com: :sun: :star: : reflection: : InvocationTargetException 
) ; 
}; 



[11 66] Method getRetumType returns an XldlClass object that represents the formal return type of the method rep- 
resented by this method object Method getParameterlypes returns a sequence of XldlClass objects that represent 
the fomial parameter types, in declaration order, of the method represented by this Method object. Method getParam- 
eterTypes returns a sequence of length 0 if the underlying method takes no parameters. 

[1 167] Method getParameterlnfos returns a sequence of Paramlnfo objects that represent all information about the 
formal parameter types, in declaration order, of the method represented by this Method object. Method getParameter- 
lnfos returns a sequence of length 0 if the underlying method takes no parameters. 

[1 168] Method getExceptionTypes returns a sequence of XldlClass objects that represent the types of the checked 
exceptions thrown by the underlying method represented by this Method object. Method getExceptionTypes returns a 
sequence of length 0 if the method thro\Are no checked exceptions. 

[1 169] Method getMode retunns an enumeration value, which denotes whether the method is one-way or two-way. 
Method invoke Invokes the underlying method represented by this method object on the specified object with the 
specified parameters. Individual parameters are subject to widening conversions as necessary. 
[1 170] Method invocation proceeds in the following order: 

If the specified object argument is NULL, the invocation throws an IllegalArgumentException; and 

[1171] Otherwise, If the specified object argument is not an instance of the class or interface declaring the underlying 

method, the invocation throws an exception IllegalArgumentException (Table 42). 

[1 172] If the number of actual parameters supplied via args is different from the number of formal parameters required 
by the underlying method, the invocation throws an Exception IllegalArgumentException. For each actual parameter 
in the supplied args array, if the parameter value cannot be converted to the coaesponding formal parameter type by 
an identity or widening conversion, the invocation throws exception IllegalArgumentException. When the control trans- 
fers to the underlying method and the method stops abruptly by throwing an exception, the exception is placed in an 
exception InvocationTargetException (Table 48) and thrown in turn to the caller of the method. If the method completes 
normally, the value it returns is returned to the caller of the method. If the underlying method returns type is void, the 
invocation returns VOID. 

[1 173] Structure Paramlnfo (Table 45) describes a formal parameter of a method. 
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TABLE 156.: STRUCTURE Paramlnfo 



struct Paramlnfo 
{ 

/** The name of the parameter. 

*/ 

string aName; 

// 

/** One of the values IN, OUT, INOUT from the ParamMode 
enumeration. 

ParamMode aMode; 

// 

/** The type of the parameter. 
V 

XldlClass aType; 

); 



[1 174] The values in Enumeration ParamMode (Table 46) are used to specify if a formal parameter of a method is 
used for input, output or both. If the value is an IN parameter, data can only transferred from the callee to the caller. If 
the value is an OUT parameter, data can only transferred from the caller to the callee. If value is an INOUT parameter, 
data can transfen-ed in both directions. 
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TABLE 157,: ENUMERATION ParamMode 



enum ParamMode 
{ 

IN, 

OUT, 

INOUT 

}; 



[1 175J The values in Enumeration Method/Wode (Table 47) are used to specify the calling mode of a method. If the 
value is an ONEWAY parameter, the method call may be asynchronous. If the value is a TWOWAY parameter, the 
method call is synchronous. 

TABLE 158.: ENUMERATION MethodMode 



enum MethodMode 

( 

ONEWAY, 
TWOWAY 

}; 



[1 1761 Exception InvocationTargetException (Table 48) is a checked exception that wraps another exception. Typi- 
cally such exceptions are thrown by an invoked method or constructor. Exception InvocationTargetException inherits 
from exception WrappedTargetException (Table 49). 
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TABLE 159,: EXCEPTION InvocationTargetException 



exception InvocationTargetException : 

com: : sun: : star: : lang: : WrappedTargetException 

{ 

}; 



[1 1 77] Exception WrappedTargetException (Table 49) is a checked exception that wraps an exception thrown by the 
original target. Nonrially this exception is declared for generic methods. Exception WrappedTargetException inherits 
from exception Exception(Table 12). 

TABLE 160.: EXCEPTION WrappedTargetException 



exception WrappedTargetException : 

com: : sun : : star : : uno: : Exception 

{ 

any TargetException; 
); 



[11781 Interface XldlArray (Table 50) provides methods to dynamically access arrays. Interface XldlArray inherits 
from interface Xinterface (Table 2). 
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TABLE 161.: INTERFACE Xldl Array 



interface XldlArray: com: :sun: : star: :uno: :XInterface 

{ 

void realloci [inout] any array/ [in] long length ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException ) ; 
long getLen( [in] any array ) 
raises ( 

com: : sun: : star : : lang: : IllegalArgumentException ) ; 
any get ( [in] any aArray, [in] long nindex ) 
raises ( 

com: : sun: : star : : lang: : IllegalArgumentException, 
com:: sun: :star: : lang: : ArraylndexOutOf BoundsExcepti 
on ) ; 

void set ( [inout] any aArray, [in] long nindex, [in] 
any aNewValue ) 
raises ( 

com: : sun: : star : : lang: : IllegalArgumentException, 
com: :sun: :star: :lang: : ArraylndexOutOf BoundsException 
) ; 
}; 



[1 1 79] Method realloc in interface XldlArray changes the size of the array to the new size. If the new length is greater, 
the additional elements are default constructed, otherwise the elements are destructed. Method realloc throws an 
exception IllegalArgumentException (Table 42) if the specified object is not an array or if the specified object is nulL 
[1 1 80] Method getLen in interface XldlArray returns the number of elements in the array. Method getLen throws an 
exception IllegalArgumentException (Table 42) if the specified object is not an array or if the spedfied object is null. 
[1 181] Method get in interface XldlArray returns the value of the indexed component in the specified array object. 
Method get throws exception IllegalArgumentException, if the specified object is not an an^ay or if the specified object 
is null. Method get throws exception ArraylndexOutOf BoundsException (Table 51), If the specified index argument is 
negative, or if the spedfied index argument is greater than or equal to the length of the specified array 
[1 1 82] Method set in interface XldlArray sets the value of the indexed component of the specified array object to the 
specified new value. Method set throws exception IllegalArgumentException, if the specified object is not an array or 
if the specified object is null. Method set throws exception ArraylndexOutOf BoundsException (Table 51), if the specified 
index argument is negative, or if the specified index argument is greater than or equal to the length of the specified array. 
[1 1 83] Exception ArraylndexOutOfBoundsExceptlon (Table 51 ) is thrown to indicate that an array has been accessed 
with an illegal index. The index Is either negative or greater than or equal to the size of the array. Exception Arrayln- 
dexOutOfBoundsExceptlon inherits from exception IndexOutOfBoundsException (Table 52). 
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TABLE 162,: EXCEPTION ArraylndexOutOfBoundsException 



exception ArraylndexOutOfBoundsException : 

com: :sun: :star: :lang: : IndexOutOf BoundsException 

{ 

}/ 



[1 184] Exception IndexOutOfBoundsException (Table 52) is thrown to indicate that a container has been accessed 
with an illegal index. The index is either negative or greater than or equal to the count of the elements. Exception 
IndexOutOfBoundsException inherits from exception Exception (Table 12). 



TABLE 163,: EXCEPTION IndexOutOfBoundsException 



exception IndexOutOfBoundsException : 
com : : sun : : star : : uno : : Exception 



}; 



[1 1 85] As explained above, Interface XFmme (Table 1 5) uses interface XController (Table 53). With interface XCon- 
troller, components viewed in a frame can serve events by supplying dispatches. Interface XController inherits from 
interface XCompone/jf (Table 16), 
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TABLE 164, : INTERFACE XController 



interface XController: com: :sun: :star: :lang: :XCoinponent 
{ 

void attachFrame ( [in] XFrame xFrame ); 
boolean attachModel ( [in] XModel xModel ); 
boolean suspend ( [in] boolean bSuspend ); 
any getViewData' ( ) ; 

void restoreViewData ( [in] any Data ); 
XModel getModel () ; 
XFrame getFrameO; 
}; 



25 

[11 86] Method attachFrame (Table 53) is called to attach the controller with Its managing frame. Method attachModel 
is called to attach the controller to a new model. Method suspend is called to prepare the controller for closing the view. 
Method getViewData returns data that can be used to restore the current view status. Method restoreViewData restores 
30 the view status using the data gotten from a previous call. Method getModel returns the currently attached model. 
Method getFrame returns the frame containing this controller. 

[1 1 87] In Table 54, Interface XMode/ represents a component, which is created from an URL and arguments. Interface 
XModel is a representation of a resource in the sense that the interface was created/loaded from the resource. The 
arguments are passed to the loader to modify its behavior. An example for such an argument is "AsTemplate", which 
35 loads the resource as a template for a new document. Models can be controlled by controller components, which are 
usually views of the model. If there is at least one controller, there Is by definition a current controller, and If that controller 
supports interface XSelectton Supplier, it has a current selection too. Interface XModel inherits from interface XCom- 
ponenf (Table 16). 
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TABLE 165. : INTERFACE XModel 



interface XModel: com: : sun: : star: : lang: rXComponent 
{ 

boolean attachResource { [in] string aURL, [in] 

sequence<com: : sun: : star: rbeans : : PropertyValue> 
aArgs ) ; 

string getURLO ; 

sequence<com: rsun: :star: rbeans: : PropertyValue> 

getArgs {) ; 
[oneway] void connectController ( [in] 

com: : sun: rstar: : frame: :XController xController ); 
[oneway] void disconnectController ( [in] 

com: :sun: : star: : frame: iXController xController ); 
[oneway] void lockControllers ( ) ; 
[oneway] void unlockControllers ( ) ; 
boolean hasControllersLocked ( ) ; 
[const] com: rsun: rstar: : frame: :XController 

getCurrentController ( ) ; 
void setCurrentController { [in] 

com: :sun: :star : : frame: :XController xController ) 

raises { 

com: :sun: :star: : container: :NoSuchElementExcep 
tion ) ; 

[const] com: : sun: : star: :uno: :XInterface 
getCurrentSelection ( ) ; 



}; 



[1188] Method attachResource (Table 54) informs a model about its resource description. Method getURL returns 
the URL of the resource, which is represented by this model. Method getArgs returns the arguments with which the 
model was originally created or stored the last time. Method connectController is called whenever a new controller is 
created for this model . Interface XComponent of the controller must be used to recognize when the controller is deleted. 
Method disconnectController is called whenever a new controller is created for this model . Again, interface XComponenf 
of the controller must be used to recognize when the controller Is deleted. 
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[1 1 89] Method lockControllers (Table 54) suspends some notifications to the controllers, which are used for display 
updates. The calls to this method may be nested and even overlapping, but the calls must be in pairs. While there is 
at least one lock remaining, some notifications for display updates are not broadcasted. 

[1 190] Method unlockControllers (Table 54) resumes the notifications, which were suspended by call to lockControl- 
5 lers. The calls to this method may be nested and even overlapping, but they must be in pairs. While there is at least 
one lock remaining, some notifications for display updates are not broadcasted. 

[11 911 Method hasControllersLocked (Table 54) determines if there is at least one lock remaining. While there is at 
least one lock remaining, some notifications for display updates are not broadcasted to the controllers. 
[1 192] Method getCurrentController (Table 54) returns the controller, which currently controls this model. If the con- 
to trolter. which is active, is a controller of this model, it will be returned. If not, the controller, which was the last active 
controller of this model, is returned. If no controller of this model ever was active, the controller first registered is 
retumed. If no controller is registered for this model, NULL is retumed. 

[1 193] Method setCun-entController (Table 54) sets a registered controller as the cun^nt controller. Method setCur- 
rentController throws exception NoSuchElementException (Table 58). 
15 [1194] Method getCurrentSelection (Table 54) returns the current selection in the current controller. If there is no 
current controller, the method retums NULL. 

[1 195] Structure PmpertyValue (Table 55) specifies a property value. Field Name (Table 55) specifies the name of 
the property. The name is unique within a sequence of PropertyValues. Field Handle (Table 55) contains an implemen- 
tation-specific handle for the property. The handle may be -1 if the implementation has no handle. If available, the 
20 handle it can be used for fast lookups. Field Value contains the value of the property or void if no value is available. 
Field State detemiines if the value comes from the object itself or from a default, and if the value cannot be determined 
exactly 



TABLE 166. : STRUCTURE PropertyValue 



struct PropertyValue 

{ 

string Name; 
long Handle; 
any Value; 

com: :sun: :star: : beans: : PropertyState State; 
}; 



45 [1 196] Enumeration PropertyState (Table 56) lists the states that a property value can have. The state consists of 
two aspects: whether a value is available or void; and whether the value is stored in the property set itself or is a default 
or ambiguous. 

[11 97] Value DIRECT. VALUE (Table 56) of the property is stored in the PropertySet itself. The property value must 
be available and of the specified type. If field PropertyAttribute in stmcture Property (Table 57) contains PropertyAt- 

50 tribute::MAYBEV01D, then the value may be void. 

[1 198] Value DEFAULT. VALUE (Table 56) of the property is available from a master (e.g. template). Field Propert- 
yAttribute in structure Property (Table 57) must contain the flag PropertyAttribute::MAYBEDEFAULT. The property 
value must be available and of the specified type. If field PropertyAttribute in the stnjcture Property contains Propert- 
yAttribute: :MAYBEVOID, the value may be void. 

55 [1 199] Value AMBIGUOUS.VALUE (Table 56) of the property is only a recommendation because there are multiple 
values for this property (e.g. from a multi selection). Field PropertyAttribute in stmcture Properf/ (Table 57) must contain 
flag PropertyAttribute::MAYBEAMBIGUOUS. The property value must be available and of the specified type. If field 
Attribute in structure Prope/t/ contains PropertyAttribute::MAYBEVOID, n the value may be void. 
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TABLE 167. ; Enumeration PropertyState 



enum PropertyState 
{ 

DIRECT_VALUE, 

DEFAULT_VALUE, 

AMBIGUOUS_VALUE 

); 



[1200] Structure Property (Table 57) describes a property. There are three types of properties: bound properties, 
constrained properties and free properties. Field Name specifies the name of the property. The name is unique within 
an XPropertySet. Field Handle contains an implementation specific handle for the property. The handle may be -1 if 
the implementation has no handle. Field Type contains an object that identifies the declared type for the property. If 
the property has multiple types or the type is not known, but not any, void must be returned. Field Attributes may contain 
zero or more constants of the PropertyAttribute constants group. 



TABLE 168.: Structure Property 



struct Property 
{ 

string Name; 
long Handle; 
TyPE__XIDLCLASS Type; 
short Attributes; 

}; 



[1201] Exception NoSuchElementException (Table 58) is thrown by the method to indicate that there are no more 
elements in the enumeration. Exception NoSuchEiementException inherits from exception Exception (Table 12). 
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TABLE 169.: EXCEPTION NoSuchElementEKception 



exception NoSuchElementException : 

com: : sun: : star: : uno: : Exception 

{ 

}; 



[1202] As explained above, interface XFrame (Table 15) uses interface XFrameActionListener {Jab\e 59). Interface 
XFrameActionUstener has to be provided if an object wants to receive events when several things happen to compo- 
nents within frames of the desktop, e.g., events of instantiation/destruction and activation/deactivation of components 
can be received. 

[1203] Interface XFrameActionUstener inherits from Interface XEventUstener (Table 17). Method frameAction is 
called whenever any action occurs to a component within a frame. 

TABLE 170,: INTERFACE XFrameActionListener 



interface XFrameActionListener: 

com: : sun : : star : : lang : : XEventListener 

{ 

(oneway] void frameAction( [in]-* 

com: : sun: : star: : frame: : FrameActionEvent aEvent ) ; 

}; 



[1 204] Event stmcture FrameActionEvent (Table 60) Is broadcast for action, which can happen to components within 
frames. Event structure FrameActionEvent inherits from structure EventObject (Table 18). 

[1205] In Table 60, field Frame contains the frame in which the event occurred. Field Action spedfies the concrete 
event. 
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TABLE 171.: Structure FrameActionEvent 



10 



15 



Struct FrameActionEvent : 

com: : sun: : star: : lang: : EventObject 

{ 

com: :sun: :star: : frame: :XFrame Frame; 
com: :sun: :star: : frame: :FrameAction Action; 
); 
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[1206] Enumeration FrameAction (Table 61) specifies the events, which can happen to components in frames. An 
event COMPONENT_ATTACHED is broadcast whenever a component is attached to a frame. This is almost the same 
as the instantiation of the component within that frame. The component is attached to the frame immediately before 
this event is broadcast. An event COMPONENT. DETACHING Is broadcast whenever a component is detaching from 
a frame. This Is quite the same as the destruction of the component, which was In that frame. At the moment when 
the event is broadcast the component is still attached to the frame but in the next moment it is not attached. An event 
C0MP0NENT_REATTACHED Is broadcast whenever a component is attached to a new model. In this case the com- 
ponent remains the same but operates on a new model component An event FRAME_ACTIVATED is broadcast when- 
ever a component is activated. Activations are broadcast from the top component, which was not active before, down 
to the Inner most component. An event FRAME. DEACTIVATING broadcast immediately before the component is 
deactivated. Deactivations are broadcast from the Innemiost component, which does not stay active up to the outer 
most component, which does not stay active. An event CONTEXT_CHANGED is broadcast whenever a component 
changed its internal context (i.e. the selection). If the activation status within a frame changes, this counts as a context 
change too. An event FRAME_UI_ACTIVATED Is broadcast by an active frame when the active frame is getting user 
interface control (tool control). An event FRAME. ULDEACTIVATING is broadcast by an active frame when the active 
frame is losing user interface control (tool control). 
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ENUMEEIATION FrameAction 



enum FrameAction 
{ 

COMPONENT_ATTACHED, 
COMPONENT^DETACHING, 
COMPONENT_REATTACHED, 
FRAME_ACT I VATE D , 
FE^ME_DEACT I VAT I NG , 
FRAME_UI_ACTIVATED, 
FRAME__U I_DEACT I VAT I NG 
J.- 



LI 207] As described above, interface XDispatchProvider (Table 62 and Fig. 9) is an interface of class BeanFrame 
(Fig. 6). Interface XDispatchProvider provides Dispatch interfaces for certain functions, which are useful at the user 
interface. Interface XD/spafc/jProw'der Inherits from Interface Xinterface (Table 2). and uses interface XDispatch (Table 
63) and structures URL (Table 64) and DispatchDescriptor {Jab\e 67). 



TABLE 173.: INTERFACE XDispatchProvider 



interface XDispatchProvider: 

com: : sun: : star: runo: : Xinterface 

{ 

com: :sun: :star: : frame: :XDispatch queryDispatch ( [in] 
com: : sun: : star : :util: : URL aURL, 

[in] string aTargetFrameName, 
[in] long nSearchFlags ); 
sequence<com: :sun: rstar: : frame: :XDispatch> 
queryDispatches ( [in] 

sequence<com: : sun : : star : : frame : : DispatchDescriptor 

> aDescripts ) ; 

}; 
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[1 208] Method queryDispatch (Table 62) searches for an XDispatch for the specified URL within the specified target 
frame. Method queryDispatches returns multiple dispatch interfaces for the specified descriptors at once. Actually this 
method is redundant to method DispatchProvider::query Dispatch to avoid multiple remote calls. 
[1 209] Interface XDispatch (Table 63) serves state infomiation of objects, which can be connected to controllers (e. 
g. toolbox controllers). Each state change is to be broadcast to all registered status listeners. The first notification 
should be performed synchronously, if not, controllers may flicker. State listener must be aware of this synchronous 
notification. The state Includes enabled/disabled and a short descriptive text of the function (e.g. "undo insert charac- 
ter). The state is to be broadcast whenever this state changes or the controller should reget the value for the URL to 
which it is connected. Additionally, a context-switch-event is to be broadcast whenever the object may be out of scope 
to force the state listener to requery the XDispatch. Interface XD/spafch inherits from interface XInterface (Table 2). 



TABLE 174.: INTERFACE XDispatch 



interface XDispatch; com: :sun: :star: :uno: :XInterface 

{ 

[oneway] void dispatch! [in] com: : sun :: star : rutil :: URL 
aURL, [in] 

sequence<com: :sun: :star: : beans: : PropertyValue> 
aArgs ) ; 

[oneway] void addStatusListener ( [in] 

com: :sun: :star: : frame : :XStatusListener xControl, 
[in] com: : sun: : star :: util: : URL aURL ); 

[oneway] void removeStatusListener ( [in] 

com: :sun: :star: : frame: ; XStatusListener xControl, 

[in] com: :sun: :star: :util: :URL aURL ); 

}/ 



[1 21 0] Method dispatch (Table 63) dispatches (executes) an URL asynchronously Method dispatch is only allowed 
to dispatch URLs for which the cun-ent user gets the dispatch. Additional arguments -'#...'• or "?.. " are allowed. 
[1211] The following is an example for a click-handler of a hyperiink in a view. 

XFrame xTargetFrame = m_xFrame- 

&gt; findPrame (m_aHyper1ink- 

&gt;getTargetFrameName (), 

FRAME_SEARCH_STANDARD ); 
URL aURL; 

aURL.Original = m_aHyperiink- 
&gt;getURL(); 

XDispatch m_xFrame-&gt;queryDispatch{ 
aURL, sequence&lt;PropertyValue&gt; Q ); 

xDispatch-&gt;dispatch( aURL ); 
[1212] Method addStatusListener (Table 63) registers a listener of a controller for a specific URL to this object to 
receive status events. This method is only allowed to register for URLs for which the current user gets this dispatch. 
Additional arguments or "?..." are ignored. Method removeStatusListener unregisters a listener of a controller 
[1213] Structure URL (Table 64) represents the original and the parsed structure of a Uniform Resource Locator. It 
is not necessary to set all of the fields; either URL::Complete or (some of) the others are set. Additionally, most of the 
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other fields, like URL.User. URL::Password or URL::Mar1c, are optional. 

[1214] In Table 64. field Complete contains the unparsed original URL, for example, 

http://me:pass@www.stardivlsion.de:8080/pub/test/foo.tx t?a=b#xyz. Field Main contains the URL without a mark and 
without arguments, for example. 

http://me:pass@www.stardivision.de:8080/pub/test/foo.bc t. Field Protocol contains the protocol (scheme) of the URL. 
for example, "http". Field User contains the user-identifier of the URL, for example, "me". Field Password contains the 
users password of the URL, for example, "pass". Field Server contains the server part of the URL, for example, "www. 
stardivision.de". Field Port contains the port at the server of the URL, for example, "8080". Field Path contains the path 
part of the URL without the filename, for example, "/pub/tesf. Field Name contains the filename part of the URL, for 
example, *^6o.txt". Field Arguments contains the arguments part of the URL, for example, "a=b". Field Mark contains 
the mark part of the URL, for example "xyz". 



TABLE 175.: STRUCTURE URL 



struct URL 
{ 

string Complete; 
string Main; 
string Protocol; 
string User; 
string Password; 
string Server; 
short Port; 
string Path; 
string Name; 
string Arguments; 
string. Mark; 
}; 



[1215] As explained above, interface XS/afusUsfener (Table 65) is used by interface XD/spafc/) (Table 63 and Figure 
9). Interface XStatusListener makes it possible to receive events when the state of a feature changes. Interface XSta- 
tusListener inhenis from interface XEventListener (Table 17). Method statusChanged is called when the status of the 
feature changes. 
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TABLE 176.: INTERFACE XStatusListener 



10 



15 



interface KStatusListener : 

com: :sun: :star: :lang: : XEventListener 

{ 

[oneway] void statusChanged ( [in] 

com: : sun: : star: : frame: : Features tateEvent Event ) ; 

}; 



20 
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[1 21 6] Stmcture FeatureStateEvent (Table 66) is broadcast by a controller, whenever the state of the feature changes. 
Structure FeatureStateEvent inherits from structure EventObject (Table 18). 

[1217] In Table 66. field FeatureURL contains the URL of the feature. Field FeatureDescriptor contains a descriptor 
of the feature for the user interface. Field tsEnabled specifies whether the feature is currently enabled or disabled. 
Field Requery specifies whether the Dispatch has to be requeried. Field State contains the state of the feature In this 
dispatch. This can be, for example, simply TRUE for a Boolean feature like underline on/off. Some simple types like 
string or Boolean are useful here for generic user interface elements, like a checkmark In a menu. 



TABLE 177.: STRUCTURE FeatureStateEvent 



30 



35 
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Struct FeatureStateEvent : 

com: : sun: : star : : lang: : EventObject 

{ 

com: : sun: : star : : util : : URL FeatureURL; 
string FeatureDescriptor; 
boolean IsEnabled; 
boolean Requery; 
any State; 
}; 



50 



[1 21 8] Structure DispatchDescriptor (Table 67) describes a feature to be retrieved by an URL that has to be loaded 
into a specified frame. Field FeatureURL specifies the URL of the resource/function. Field FrameName is the name of 
the target frame. Field SearchFlags Is how the target frame is to be searched. 
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TABLE 178.: STRUCTURE DxspatchDescriptor 



10 
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Struct DispatchDescriptor 
{ 

com: : sun: : star : :util : :URL FeatureURL; 
string FrameName; 
long SearchFlags; 
}; 



20 In the embodiment of Figure 6, the component loaded Is StarWriter, and class StarWriter includes interface XLoadable 
(Table 68 and Figure 9). Interface XLoadable provides functionality to implement objects, which may be loaded. Inter- 
face XLoadable inherits from interface XInterface (Table 2). 
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TABLE 179.: INTERFACE XLoadable 



30 



35 



40 



interface XLoadable: com: :sun: :star: :uno: :XInterface 
{ 

[oneway] void load(); 

[oneway] void unloadO; 

[oneway] void reload(); 

boolean isLoadedO; 

[oneway] void addLoadListener ( [in] 

com: :sun: :star: :form: : XLoadListener aListener ); 
(oneway] void removeLoadListener ( [in] 

com: : sun: :star: : form: : XLoadListener aListener ) ; 

}; 
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[1219] Method load (Table 68) starts the data processing. Method unload stops the data processing. Method reload 
does a smart refresh of the object. The final state is the same as if unload and load were called, but reload is the more 
efficient way to do the same. If the object isn't loaded, nothing happens. Method isLoaded retums true if the object Is 
in loaded state. Method addLoadListener adds the specified listener to receive events "loaded" and "unloaded." Method 
removeLoadListener removes the specified listener. 

[1220] Interface XLoadListener (Table 69) is used in the load listener method calls in Table 68. Interface XLoadLis- 
tener receNes "loaded" and "unloaded" events posted by a loadable object. The interface Is typically implemented by 
data-bound components, which want to listen to the data source that contains their database fomn. Interface XLoad- 
Listener \nhenta from Interface XEvenfUsfener (Table 17). 
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TABLE 180, 



INTERFACE XLoadListener 
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interface XLoadListener: 

com: :sun: :star: :lang: :XEvent Listener 

I 

(oneway] void loaded! [in] 

com: : sun: : star: : lang: : EventObject aEvent ) 
[oneway] void unloading { [in] 

com: : sun: : star :: lang: : EventObject aEvent ) 
[oneway] void unloaded ( [in] 

com: : sun: : star: : lang: : EventObject aEvent ) 
[oneway] void reloading ( [in] 

com: : sun: : star :: lang: : EventObject aEvent ) 
[oneway] void reloaded ( [in] 

com: : sun: : star :: lang: : EventObject aEvent ) 

}; 



40 



[1221] Method loaded (Table 69) is invoked when the object has successfully connected to a data source. Method 
unloading is invoked when the object Is about to be unloaded. Components may use this to stop any other event 
processing related to the event source before the object is unloaded. Method unloaded is Invoked after the object has 
disconnected from a data source. Method reloading Is invoked when the object Is about to be reloaded. Components 
may use this to stop any other event processing related to the event source until they get the reloaded event. Method 
reloaded is invoked when the object has been reloaded. 

[1 222] Class BeanWindow (Fig. 6) indudes interfaces XWindowPeer (Table 70) and XEventHdl (Table 4). Interface 
XWindowPeer giwes access to the actual window implementation on the device. Interface XWindowPeer inherits from 
Interface XComponenf (Table 16), and uses Interfaces XToo/K/f (Table 71 ) and XPointer (Table 88), which are described 
below. See also Figures 10A and 10B. 
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INTERFACE XWindowPeer 



interface XWindowPeer : com: :sun: :star: :lang: iXComponent 
{ 

XToolkit getToolkit 0 ; 

[oneway] void setPointer( [in] XPointer Pointer ); 
[oneway] void setBackground ( [in] long Color ); 
[oneway] void invalidate { [in] short Flags ); 
[oneway] void invalidateRect ( [in] Rectangle Rect, [in] 
short Flags ) ; 
}; 



[1223] Method getToolkit (Table 70) returns the visual class, which created this object. Method setPointer sets the 
mouse pointer. Method setBackground sets the background color. Method Invalidate invalidates the whole window 
using an InvalidateStyle. Method invalidateRect invalidates a rectangular area of the window using an InvalidateStyle. 
[1224] lnterfaceX7boM(Table 71) specifies a factory interface for the windowing toolkit. This is similar to the abstract 
window toolkit (AWT) in JAVA. Interface X7oo//f/f inherits from interface XInterface (Table 2). 
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TABLE 182.: INTERFACE XToolkit 



interface XToolkit: com: : sun: : star; :uno: :XInterf ace 
{ 

com: :sun: rstar: :awt: rXWindowPeer getDesktopWindow ( ) ; 

com: : sun: : star : : awt : : Rectangle getWorkArea ( ) ; 

com: :sun: :star: :awt: rXWindowPeer createWindow { [in] 

com: : sun: : star: :awt: :WindowDescriptor Descriptor ) 
raises ( 

com: : sun: : star: : lang: : IllegalArgumentException ) ; 
sequence<com: : sun: : star: ;awt : : XWindowPeer> 
createWindows ( [in] 

sequence<com: : sun: : star : : awt : : WindowDescriptor> 
Descriptors ) 
raises ( 

com: : sun: : star: : lang: : IllegalArgumentException ) ; 
com: : sun: : star : :awt : :XDevice 

createScreenCompatibleDevice ( [in] long Width, 
[in] long Height ) ; 
com: : sun : : star : : awt : : XRegion createRegion ( ) ; 

}; 



[1 225] Method getDesktopWindow (Table 7 1 ) returns the desktop window. Method getWorkArea returns the complete 
work area for this toolkit. Method createWindow creates a new window using the given descriptor. Method createWin- 
dow throws exception lllegalArgumentException(Table 42). Method createWindows returns a sequence of windows, 
which are newly created using the given descriptors. Method createWindows throws exception lilegalArgumentExcep- 
tion Method createScreenCompatibleDevice creates a virtual device that is compatible with the screen. Method crea- 
teRegion creates a region. 

[1 226] Structure WindowDescriptor (Table 72) describes a window. Field Type specifies the type of window. Field 
WindowServiceName specifies the name of the component service f ListBox", "PushButton^. A zero length name 
means that the vd creates a blank top, a container, or a simple window. Field Parent specifies the parent of the com- 
ponent. If the Parent == 0 && Parentlndex == -1 . the window is on the desktop. Field Parentlndex specifies the index 
of the parent window, if available. If Parent == 0 and this structure is a^member of an array, this is the offset from the 
beginning of the array to the parent. A value of -1 means desktop. Field Bounds specifies the position and size of the 
window. This member is ignored if the window attribute is WA_FULLSIZE. Field WindowAttributes contains some of 
the WA_* attributes. 
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TABLE 183.: STRUCTURE WindowDescrlptor 



10 



struct WindowDescriptor 

com: :sun: :star: : awt : : WindowClass Type; 

string WindowServiceName; 



com: :sun: :star: :awt: :XWindowPeer Parent; 
short Parent Index; 

com: :sun: : star: :awt: :Rectangle Bounds; 

long WindowAttributes; 

}; 



25 [1 227] Enumeration WindowClass (Table 73) spedfies the class of a window. Value TOP specifies a top-level window 
on the desktop. It Is also a container. Value MODALTOP is a modal top-level window on the desktop. It is also a 
container. Value CONTAINER is a container that may contain other components. It is not a top window. Value SIMPLE 
is the simplest window. It can be a container. 

30 

TABLE 184.: ENUMERATION ?^indowClass 



enum WindowClass 
{ 

TOP, 

MODALTOP, 

CONTAINER, 

SIMPLE 

}; 



50 [1 2281 1 nterf ace XDevice (Table 74 and Figure 1 0A) provides inf omiation about a graphical output device and offers 
a factory for the graphics, which provides write operations on the device. Interface XDevice inherits from interface 
XInterface (Table 2). 
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TABLE 185.: INTERFACE XDevice 



interface XDevice: com: : sun: : star: :uno: :XInterf ace 
{ 

XGraphics createGraphics ( ) ; 

XDevice createDevice ( [in] long nWidth, [in] long 
nHeight ) ; 

com: :sun: :star: :awt: :DeviceInfo getlnfoO ; 
sequence<FontDescriptor> getFontDescriptors ( ) ; 
com::sun::star::awt::XFont getFont( [in] FontDescriptor 

aDescriptor ) ; 
XBitmap createBitmap( [in] long nX, [in] long nY, 

[in] long nWidth, [in] long nHeight ); 
XDisplayBitmap createDisplayBitmap ( [in] XBitmap Bitmap 

) ; 
); 



[1 229] Method createGraphics (Table 74) creates a new graphics, which output operation direct to this device. Method 
createDevice creates a new device, which is compatible with this one. If the device does not support the GETBITS 
device capability, this method returns NULL. Method getlnfo returns information about the device. Method getFontDe- 
scriptors returns the list of available font descriptors. 

[12301 Method getFont (Table 74) returns infomiation about a font offered by this device. Parameter aDescriptor 

specifies the description of a font, and specifies that the unit of measure is pixel for this device. 

[1 231] Method createBitmap (Table 74) creates a bitmap with the current device depth. If the specified area does 

not lie entirely in the device, the bits outside are not specified. Method createDisplayBitmap creates a device-compatible 

bitmap. The data of the bitmap is in process memory instead of in the device, so the output operation is fast. 

[1 232] Interface XGraphics (Table 75) provides the basic output operation of a device. Interface XGraphics inherits 

from interface XInterface (Table 2). 
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TABLE 186.: INTERFACE XGraphics 



interface XGraphics: com: : sun: : star: :uno: rXInterface 
{ 

XDevice getDevice ( ) ; 

SimpleFontMetric getFontMetric ( ) ; 

[oneway] void setFont( [in] XFont xNewFont ); 

[oneway] void selectFontC [in] FontDescriptor 

aDescription ) ; 
[oneway] void setTextColor{ [in] long nColor ); 
[oneway] void setTextFillColor ( [in] long nColor ); 
(oneway] void setLineColor ( [in] long nColor >; 
[oneway] void setFillColor { [in] long nColor ); 
[oneway] void setRasterOp( [in] RasterOperation ROP ); 
[oneway] void setClipRegion { [in] XRegion Clipping ); 
[oneway] void intersectClipRegion ( [in] XRegion 

xClipping ) ; 
[oneway] void push(); 
[oneway] void pop ( ) ; 

[oneway] void copy ( [in] XDevice xSource, [in] long 
nSourceX, [in] long nSourceY, [in] long 
nSourceWidth, [in] long nSourceHeight, [in] long 
nDestX, [in] long nDestY, [in] long nDestWidth, 
[in] long nDestHeight ) ; 
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[oneway] void ciraw( [in] XDisplayBitmap xBitmapHandle, 

(in) long SourceX, [in] long SourceY, [in] long 

SourceWidth, [in] long SourceHeight , [inj long 

DestX, [in] long DestY, [in] long DestWidth, [in] 

long DestHeight ) ; 
[oneway] void drawPixel ( . [in] long X, [in] long Y ); 
[oneway] void drawLineC [in] long XI, [in] long Yl, 

[in] long X2, [in] long Y2 ); 
[oneway] void drawRect ( [in] long X, [in] long Y, [in] 

long Width, [in] long Height ); 
(oneway] void drawRoundedRect ( [in] long X, [in] long 

Y, [in] long Width, [in] long Height, [in] long 

nHorzRound, [in] long nVertRound ); 
[oneway] void drawPolyLine ( [in] sequence<long> DataX, 

[in] sequence<long> DataY ) ; 
[oneway] void drawPolygon( [in] sequence<long> DataX, 

[in] sequence<long> DataY ) ; 
[oneway] void drawPolyPolygon ( [in] sequence< 

sequence<long> > DataX, [in] sequence< 

sequence<long> > DataY ) ; 
[oneway] void drawEllipse{ [in] long X, [in] long Y, 

[in] long Width, [in] long Height ); 
[oneway] void drawArc( [in] long X, [in] long Y, [in] 

long Width, [in] long Height, [in] long XI, [in] 

long Yl, [in] long X2, [in] long Y2 ); 
[oneway] void drawPie( [in] long X, [in] long Y, [in] 

long Width, [in] long Height, [in] long XI, 

[in] long Yl, [in] long X2, [in] long Y2 ); 
(oneway] void drawChord( [in] long nX, [in] long nY, 

[in] long nWidth, [in] long nHeight, [in] long 

nXl, [in] long nYl, [in] long nX2, [in] long nY2 

); 

(oneway] void drawGradient ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long Height, [in] Gradient 
aGradient ) ; 

[oneway] void drawText ( [in] long X, [in] long Y, 
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[in] string Text ); 
[oneway] void drawTextArray ( [in] long X, [in] long Y, 

[in] string Text, [in] sequence<long> Longs ) ; 
}; 



10 

[1 233] Method getDevice (Table 75) returns the device of this graphics. Method getFontMetric returns the font metric 
of the current font. Method setFont sets the font used by text operations. Method selectFont creates a new font and 
sets the font Method setTextCoIor sets the text color used by text operations. Method setTextFi II Color sets the fill color 
used by text operations. Method setUneColor sets the line color. Method setFIIIColor sets the fill color. Method set- 
ts RasterOp sets the raster operation. If the device does not support raster operations, this call is ignored. Method set- 
ClipRegion sets the dip region to specified clipping. Method intersectClipRegion builds the intersection with the current 
region. Method push saves all current settings (Font. TextColor, TextFillColor. LineColor, FillColor, RasterOp, 
ClipRegion). Method pop restores all previous saved settings. Method copy copies a rectangle of pixels from another 
device into this one. Method draw draws a part of the specified bitmap to the output device. Method drawPixel sets a 
20 single pixel in the output device. Method drawUne draws a line in the output device. Method drawRect draws a rectangle 
in the output device. Method drawRoundedRect draws a rectangle with rounded comers In the output device. Method 
drawPolyLine draws multiple lines in the output device at once. Method drawPolygon draws a polygon line in the output 
device. Method drawPolyPolygon draws multiple polygons in the output device at once. Method drawEllipse draws an 
ellipse in the output device. Method drawArc draws an arc (part of a circle) in the output device. Method drawPie draws 
25 a circular area in the output device. Method drawChord draws a chord of a circular area in the output device. A chord 
is a segment of a circle. You get two chords from a circle if you intersect the circle with a straight line joining two points 
on the circle. Method drawGradient draws a color dispersion in the output device. Method drawText draws text in the 
output device. Method drawTextAn-ay draws texts in the output device using an explicit keming table. 
[1234] Structure SimpleFontMetric (Table 76) describes the general metrics of a font. Field Ascent specifies the 
30 portion of a lower case character that rises above the height of the character "x" of the font. For example, the letters 
'b', 'd', 'h', 'k* and T have an ascent unequal to C: Ascent is measured in pixels, thus the font metric is device dependent. 
Field Descent specifies the portion of a letter falling below the baseline. For example, the letters 'g', 'p\ and y have a 
descent unequal to 0. Descent Is measured in pixels, thus the font metric is device dependent. Field Leading specifies 
the vertical space between lines of this font, and is also called intemal line spacing. The leading is measured in pixels, 
35 thus the font metric is device dependent. Field Slant specifies the slant of the characters (italic). The slant is measured 
in degrees from 0 to 359: Field FirstChar specifies the code of the first printable character in the font. Field LastChar 
specifies the code of the last printable character in the font. 

40 TABLE 187,: STRUCTURE SimpleFontMetric 



struct SimpleFontMetric 
{ 

short Ascent; 
short Descents- 
short Leading; 
char FirstChar; 
char LastChar; 
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[1235] Interface XFont (Table 77) describes a font on a specific device. All values are in pixels within this device. 
Interface XFont inherits from interface XInterface (Table 2). 

TABLE 188.: INTERFACE XFont 



interface XFont : com: :sun: :star: :uno; rXInterface 

{ 

com: : sun: : star : : awt : : FontDescriptor 

getFontDescriptor ( ) ; 
com: :sun: :star: :awt : : SimpleFontMetric getFontMetric ( ) ; 
short getCharWidth ( [in] char c ); 

sequence<short> getCharWidths ( [in] char nFirst, [in] 

char nLast ) ; 
long getStringWidth ( [in] string str ); 
long getStringWidthArray ( [in] string str, [out] 

sequence<long> aDXArray ) ; 
void getKernPairs ( [out] sequence<char> Charsl, [out] 

sequence<char> Chars2, [out] sequence<short> Kerns 



) ; 
}; 



[1236] Method getFontDescriptors (Table 77) returns the description of the font. Method getFontMetric returns ad- 
ditional infomnation about the font Method getCharWidth returns the width of the specified character measured in pixels 
for the device. Method getCharWidths retums a sequence of the widths of subsequent characters for this font. Method 
getStringWidth retums the width of the specified string of characters measured in pixels for the device. Method get- 
StringWidthArray retums thie width of the specified string of characters measured in pixels for the device. In this method, 
parameter aDXArray receives the width of every single character measured in pixels for the device. Method getKern- 
Pairs queries the kerning pair table. 

[1 237] Structure FontDescriptor (Table 78) describes the characteristics of a font. For example, this structure can be 
used to select a font. Field Name specifies the exact name of the font ("Anal", "Courier", "Frutiger"). Field Height 
specifies the height of the font in the measure of the destination. Field Width specifies the width of the font in the 
measure of the destination. Field StyleName specifies the style name of the font ("Bold", "Fett", "Italic Bold"). Field 
Family specifies the general style of the font. Use one value out of the constant group FontFamily. Field CharSet 
specifies the character set, which is supported by the font. Use one value out of the constant group CharSet Field 
Pitch specifies the pitch of the font. 

[1238] Use one value out of the constant group FontPitch. Field CharacterWidth spedftes the character width. De- 
pending on the specified width, a font that supports this width may be selected. The value is expressed as a percentage. 
Field Weight specifies the thickness of the line. Depending on the specified weight, a font that supports this thickness 
may be selected. The value is expressed as a percentage. Field Slant spedfies if there is a character slant (italic). 
Field Underiine uses one value out of the constant group FontUnderiine. Field Strikeout uses one value out of the 
constant group FontStrikeout. Field Orientation specifies the rotation of the font The unit of measure is degrees; 0 is 
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the baseline. Field Kerning, for requesting, it specifies if there is a kerning table available: for selecting, it specifies if 
the kerning table is to be used. Field WordLlneMode specifies if only words get underlined. A value of TRUE means 
that only non-space characters get underlined while a value of FALSE means that the spacing also gets underlined. 
This property is only valid if the property FontDescriptor::Underline is not FontUndertine::NONE. Field Type specifies 
the technology of the font representation. One or more values out of the constant group FontType can be combined 
by an arithmetical or-operation. 



TABLE 189.: STRUCTURE FontDescriptor 



struct FontDescriptor 
.{ 

string Name; 
short Height; 



short Width; 

string StyleName; 

short Family; 

short CharSet; 

short Pitch; 

float CharacterWidth; 

float Weight; 

com: :sun: : star: :awt: : FontSlant Slant; 
short Underline; 
short Strikeout; 
float Orientation; 
boolean Kerning; 
boolean WordLineMode; 
short Type; 
}; 



[1 239] Enumeration FontSlant (Table 79) is used to specify the slant of a font. Value NONE specifies a font without 
slant. Value OBLIQUE spedfies an oblique font (slant not designed into the font). Value ITALIC specifies an italic font 
(slant designed into the font). Value DONTKNOW spedfies a font with an unknown slant. Value REVERSE_OBLIQUE 
spedfies a reverse oblique font (slant not designed into the font). Value REVERSE.ITALIC specifies a reverse italic 
font (slant designed into the font). 
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TABLE 190.: ENUMERATION FontSlant 



enum FontSlant 
{ 

NONE, 
OBLIQUE, 



ITALIC, 
DONTKNOW, 
REVERSE_OBLIQUE, 
REVERSE_ITALIC 

}; 



[1240] The values in enumeration RasterOperation (Table 80) are used to specify the binary pixel-operation applied 
when pixels are written to the device. Value OVERPAINT sets all pixels as written In the output operation. Value XOR 
uses the pixel written as one and the current pixel as the other operator of an exclusive or-operation. Value ZERO 81 TS 
causes all bits, which are affected by this operation, to be set to 0. Value ALLBITS causes all bits, which are affected 
by this operation, to be set to 1. Value INVERT causes all bits, which are affected by this operation, to be inverted. 



TABLE 191.: ENUMEEU\TION RasterOperation 



enum RasterOperation 

{ 

OVERPAINT, 
XOR, 

ZEROBITS, 

ALLBITS, 

INVERT 

}; 



[1241] InterfaceXReg/on (Table 81 and Figures lOAand 108) manages multiple rectangles, which make uparegion. 
[1 242] Interface XRegion Inherits from interface Xtnterface (Table 2). 
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TABLE 192.: INTERFACE XRegion 



interface XRegion: com: :sun: :star: :uno: :XInterface 
{ 

Rectangle getBounds ( ) ; 
[oneway] void clearO; 

[oneway] void move { [in] long nHorzMove, [in] long 
nVertMove ) ; 

[oneway] void unionRectangle ( [in] Rectangle Rect )/ 
[oneway] void intersectRectangle ( [in] Rectangle Region 
) ; 

[oneway] void excludeRectangle ( [in] Rectangle Rect ); 
[oneway] void xOrRectangle ( [in] Rectangle Rect ); 
[oneway] void unionRegion ( [in] XRegion Region ); 
[oneway] void intersectRegion ( [in] XRegion Region ); 
[oneway] void excludeRegion ( [in] XRegion Region ); 
[oneway] void xOrRegion( [in] XRegion Region ); 
sequence<Rectangle> getRectangles ( ) ; 
); 



[1243] Method getBounds (Table 81) returns the bounding box of the shape. Method clear makes this region an 
empty region. Method move moves this region by the specified horizontal and vertical delta. Method unionRectangle 
adds the specified rectangle to this region. Method intersectRectangle intersects the specified rectangle with the current 
region. Method excludeRectangle removes the area of the specified rectangle from this region. Method xOrRectangle 
applies an exduslve-or operation with the spedfied rectangle to this region. 

[1 244] Method unionRegion adds the specified region to this region. Method intersectRegion intersects the spedfied 
region with the cun^ent region. Method excludeRegion removes the area of the specified region from this region. Method 
xOrRegion applies an exdusive-or operation with the spedfied region to this region. Method getRectangles returns all 
rectangles, which are making up this region. 

[1 245] Interface XDisptayBitmap (Table 82) spedfies an object as a bitmap for which data is formatted for a spedfic 
output device. Drawing of this bitmap is only valid on a compatible device. Interface XDisplayBitmap inherits fi-om 
interface XInterface (Table 2). 
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TABLE 193.: INTERFACE XDisplayBitmap 



interface XDisplayBitmap: 

com: : sun: : star: :uno: :XInterface 

{ 

); 



[1246] ' Starcture Gradient (Table 83) describes a color dispersion within an area. Field Style specifies the style of 
the gradient. Field StartColor specifies the color at the start point of the gradient. Field EndColor specifies the color at 
the end point of the gradient. Field Angle specifies the angle of the gradient in 1/10 degree. Field Border specifies the 
percent of the total width where just the start color is used. Field XOffset specifies the X-coordinate. where gradient 
begins. Field YOffset specifies the Y-coordinate, where gradient begins. Field Startlntenslty specifies the intensity at 
the start point of the gradient. Field Endlntenslty specifies the intensity at the end point of the gradient. Field StepCount 
specifies the number of steps of change color. 

TABLE 194.: STRUCTURE Gradient 



struct Gradient 
{ 

com: : sun: :star: tawt: : GradientStyle Style; 
long StartColor; 
long EndColor; 
short Angle; 
short Border; 
short XOffset; 
short YOffset; 
short Startlntensity; 
short Endlntensity; 
short StepCount; 
}; 



[1 247] Enumeration GradientStyle (Table 84) specifies the style of color dispersion. Value LINEAR specifies a linear 
gradient. Value AXIAL specifies an axial gradient. Value RADIAL specifies a radial gradient. Value ELLIPTICAL spec- 
ifies an elliptical gradient Value SQUARE specifies a gradient in the shape of a square. Value RECT specifies a gradient 
in the shape of a rectangle. 
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TABLE 195.: ENUMEEIATION GradientStyle 



10 



20 



enum GradientStyle 

{ 

LINEAR, 

AXIAL, 

RADIAL, 

ELLIPTICAL, 

SQUARE, 

RECT 



25 



30 



[1248] Structure Devicelnfo (Table 85) contains information about a device. Field Width contains the width of the 
device in pixels. Field Height contains the height of the device In pixels. Field Leftlnset contains the Inset from the left. 
Field Toplnset contains the inset from the top. Field Rightlnset contains the inset from the right. Field Bottomlnset 
contains the inset from the bottom. Field Pixel PerMeterX contains the X-axis resolution of the device In pixel/meter. 
Field Pixel PerMeterY contains the Y-axis resolution of the device in pixel/meter. Field BitsPerPixel contains the color- 
depth of the device. Field Capabilities specifies special operations, which are possible on the device. 



TABLE 196, 



STRUCTURE Devicelnfo 



35 



Struct Devicelnfo 



40 



45 



SO 



55 
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I 

long Widths- 
long Heights- 
long Leftlnset; 
long Toplnset; 
long Rightlnset; 
long Bottomlnset ; 
double PixelPerMeterX; 
double PixelPerMeterY; 
short BitsPerPixel; 
long Capabilities; 
); 



[1249] Interface XBitmap (Table 86) provides a bitmap in the Microsoft DIB fomnat. Interface XBitmap inherits from 
interface X/nferfece (Table 2). Method getSize returns the size of the bitmap in pixels. Method getDIB returns the device 
Independent bitmap. Method getMaskDIB retums the transparence mask of the device Independent bitmap. 



TABLE 197.: INTERFACE XBitmap 



interface XBitmap: com: :sun: :star: :uno: :XInterface 
{ 

com: :sun: :star: rawt: rSize getSizeO ; 
sequence<byte> getDIB(); 
sequence<byte> getMaskDIB () ; 
}; 



[1250] Structure Size (Table 87) specifies the two-dimensional size of an area using width and height. Field Width 
specifies the width. Field Height specifies the height. 
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STRUCTURE Size 



10 



struct Size 

{ 

long Width; 
long Height; 



20 



[1251] Interface XPointer (Table 88) gives access to the type of mouse pointer. Interface XPointer inherits from in- 
terface XInterface (Table 2). Method setType selects a SystemPointer for this mouse pointer. Method getType returns 
the currently set SystemPointer of this mouse pointer. 



TABLE 199.: INTERFACE XPointer 

25 



interface XPointer: com: 
{ 

[oneway] void setType ( 


: sun 


: star : :uno: : XInterface 


[in] 


long nType ) ; 


long getType ( ) ; 






}; 







40 [1252] Table 89 is one embodiment of a remote virtual device interface XRmVirtualDevice that is included In one 
embodiment of lightweight component 230. 



45 
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TABLE 200- : INTERFACE XRmVirtual Device 



interface XRmVirtualDevice : 

com: : sun : : star : : uno: tXInterf ace 

{ 

[oneway] void Create { [in] unsigned long nCompDev, 

[in] long nWidth, [in] long nHeight, [in] unsigned 

short nBitCount ) ; 
[oneway] void SetOutputSizePixel ( [in] long nWidth^ 

[in] long nHeight ); 
[oneway] void ResizeOutputSizePixel ( [in] long nWidth, 

[in] long nHeight ); 

}; 



[1 253] Table 90 is one embodiment of interfaces XRmBitmap and XAmJavaBitmap that are included In one embod- 
iment of lightweight component 230. These interfaces are used when a runtime environment component on server 
computer system needs to display a bitmap on user device 1 02i. 

TABLE 201.: INTERFACES XRmBitmap and XRmJavaBitmap 



interface XRmBitmap : com: :sun: :star: :uno: :XInterface 
{ 

/** 

InitiateTransf er : initialize bitmap to empty with 
width, height and depth the next parameters 
determine the format of the scanlines transported 
by subsequent Transfer calls: palette for palette 
bitmaps, the palette entries are in the order 
• blue(or index), green, red, bool- the bool tells 
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whether the first byte is an index or not . 
(implementation detail: this is a vcl BitmapColor) 
format and scanlinesize determine how to interpret 
the scanlines transported in each Transfer call, 
compressiontype marks the compression algorithm 
used on the byte sequences in Transfer call with 0 
meaning uncompressed. InitiateTransf er with width 
and height set to 0 is legal, the bitmap data 
should be purged then. 

*/ 

[oneway] void InitiateTransf er ( [in] long width, 

[in] long height, [in] long depth, [in] sequence<- 
byte > palette, [in] long format, [in] long 
scanlinesize, [in] long compressiontype ); 

/* * 

* Transfer: transports one or more scanlines of the 
bitmap initialized in InitiateTransf er . 

*/ 

(oneway] void Transfer ( [in] ByteSequence aData ); 
unsigned long QueryBitmapPtr ( ) ; 

[oneway] void Draw( [in] long nDestX, [in] long 
nDestY, [in] long nDestWidth, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 
[in] long nSrcWidth, [in] long nSrcHeight, [in] 
XRmOutputDevice xOutputDevice ) ; 

[oneway] void DrawEx( [in] long nDestX, [in] long 
nDestY, [in] long nDestWidth, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 
[in] long nSrcWidth, (in] long nSrcHeight, [in] 
XRmBitmap xBitmap, [in] XRmBitmap xBitmapMask, 
[in] XRmOutputDevice xOutputDevice, [in] boolean 
bAlpha ) ; 

[oneway], void DrawMask( [in] long nDestX, [in] long 
nDestY, [in] long nDestWidth, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 
[in] long nSrcWidth, [in] long nSrcHeight, [in] 
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XRmBitmap xBitmap, [in] unsigned long nColor, [in] 

XRmOutputDevice xOutputDevice ) ; 
[oneway] void CreateBititiap { [in] long nX, [in] long 

nY, [in] long nWidth, [in] long nHeight, [in] 

XRmOutputDevice xOutputDevice ) ; 
void GetBitmap( [out] ByteSequence rOata ); 



interface XRmJavaBitmap : XRmBitmap 



(oneway] void SetlmageData ( [in] long nBitCount, [in] 
long nWidth, [in] long nHeight, [in] ByteSequence 
aColorMap, [in] ByteSequence aIndexData, [in] 
LongSequence aRGBData) ; 

void GetlmageData { [out] long rBitCount, [out] 
long rWidth, [out] long rHeight, [out] 
ByteSequence rColorMap, [out] ByteSequence 
rBitmapData, [out] LongSequence rRGBData/ 
[out] long rAlphaMask, [out] long rRedMask, 
[out] long rGreenMask, [out] long rBlueMask) ; 



[1254] Table 91 is one embodiment of interfaces XRmRhntObsen/er, XRmPrinterEnvironment, XRmPrinten and 
XRmPrintSpoolertUBX are included in one embodiment of lightweight component 230. These interfaces are used when 
a mntime environment component on server computer system needs to print to a printer coupled to user device 102i. 
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TABLE 202.: INTERFACES XRmPrintObserver, 
XRmPrinterEnvironmentr XRmPrinter^ and XRmPrintSpooler 



{ 

// [in] Eingabe-Parameter. Der "Server" auf dem das 

Object liegt ist der Remote-Client. 
// Also "Server" eigentlich "Display" 
// (oneway] => Kein warten auf Antwort 
typedef sequence< byte, 1 > RmJobSetup; 
typedef sequence< byte, 1 > EtoQueuelnfo; 
typedef sequence< byte, 1 > RmPrinterPage; 
typedef sequence< string, 1 > StringSequence; 

interface XRmPrinterObserver : 

com: :sun: :star: :uno: rXInterface 

{ 

[oneway] void PrinterSettingsChanged ( ) ; 
}; 

interface XRmPrinterEnvironment : 

com: :sun: : star: :uno: :XInterface 

unsigned short GetQueueCount ( ) ; 

void GetQueuelnfo ( [in] unsigned short nQueue, [out] 

RmQueuelnfo rRmQueueInf o ) ; 
boolean Get Printerinf o ( [in] string sPrinterName, 

[out] RmQueuelnfo rElmQueueInf o ); 
void GetPrinterNames ( [out] StringSequence 

rPrinterNames ) ; 
stringGetDef aultPrinterName 0 ; 

void SetObserver( [in] XRmPrinterObserver rObserver ); 
}; 
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interface XRmPrinter : com: : sun: : star: :uno: :XInterf ace 
I 

void Create ( [in] RmQueuelnfo aRmQueuelnf o, [out] 

RmJobSetup rE^JobSetup ) ; 
boolean SetJobSetup( [inout] RmJobSetup rRmJobSetup ); 
boolean SetOrientation ( [in] unsigned short 

nOrientation, [inout] RmJobSetup rRmJobSetup ); 
boolean SetPaperBin{ [in] unsigned short nPaperBin, 

[inout] EtoJobSetup rRmJobSetup ); 
boolean SetPaper( [in] unsigned short nPaper, [inout] 

RmJobSetup rRmJobSetup ) ; 
boolean SetPaperSizeUser ( [in] long nWidth, [in] long 

nHeight, [inout] RmJobSetup rRmJobSetup ); 
void GetPageInfo( [out] long rOutWidth, [out] long 

rOutHeight, [out] long rPageOffX, [out] long 

rPageOffY, [out] long rPageWidth, [out] long 

rPageHeight > ; 
unsigned short GetPaperBinCount ( ) ; 
string GetPaperBinName ( [in] unsigned short 

nPaperBin ) ; 

/** query the printer for its capabilities (mainly to 
decide whether it is possible to bring up a 
printer setup dialogue) 

*/ 

unsigned long GetCapabilities ( [in] unsigned short 
nType ) ; 

/** brings up a UI to setup the current jobsetup. 

Returns the modified (and still current ) jobsetup 
if successful. If not successful (e.g. user 
cancel) the return is empty. Mote: return is 
delivered as a UserEvent on the EventListener of 
xParent 

*/ 

[oneway] void UserSetup( [in] XElmFrameWindow xParent, 
[in] unsigned long EventID ); 
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interface XElmSpoolLauncher -: 

com: ;sun: :star: :uno: :XInterface 

{ 

boolean LaunchSpooler ( [in] string sUserName, fin] 
string sPassword ) ; 

); 

interface XElmPrintSpooler : 

com: :sun: rstar: :uno: rXInterface 

{ 

void Create ( [in] RmJobSetup jobSetup ); 

boolean Start Job { [in] unsigned short nCopies, [in] 
boolean bCollate/ [in] string aJobName, [in] 
string sFileName , [in] boolean bPrintFile) ; 

[oneway] void SpoolPage( [in] RmPrinterPage page ); 

void Abort Job (); 

void EndJob ( ) ; 

); 

); 



[1 255] Table 92 is one embodiment of interface XRmFileStmam. Table 93 is one embodiment of interface XRmFSys. 
Both of these Interfaces are included in one embodiment of lightweight component 230. These Interfaces are used 
when a runtime environment component reads or writes data on a storage medium of user device 1021, or needs to 
obtain information about data stored on a storage medium of user device 1 02i Jn this embodiment, object BeanService 
532 receives, as described above, a handle to object ClientFactory 515. The handle to object ClientFactory 515 to 
instantiate an object on the user device to access a particular capability on the user device, e.g.. the file system, printing, 
sound, etc. 
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TABLE 203.: INTERFACE XRmFileStream 



{ 

typedef sequence< byte, 1 > RFSByteSequence; 
interface XRmFileStream : 

com : : sun : : star : : uno : : XInterf ace 
{ // interface 

// param aFilename: file to open 
// param nOpenMode: file mode read 
//param bIsOpen: file opend successfully 
// param bIsWritable: file opend writable 
// param nStreamMode: stream mode 
// param nError: Error Code 
// returns fileHandle: handle 

unsigned long open { [in] string aFilename, 

[in].unsigned short nOpenMode, [out] boolean 
bIsOpen, [out] boolean bIsWritable, [out] 
unsigned short nStreamMode, [out] unsigned long 
nError) ; 

// param handle: filehandle 

void close ( ) ; 

// param aData: data read from stream 
// param nSize: number of bytes to read 
// param nError: errorcode 

// returns: number of bytes that were successfully read 
unsigned long getData ( [out] RFSByteSequence aData, 

[in] unsigned long nSize, [out] unsigned long 

nError) / 

// param nData: data to write to stream 

// param nSize: number of bytes to write 

// param nError: errorcode 

// returns: number of bytes that were successfully 
// written 
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unsigned long putData([in] RFSByteSequence aData, [in] 
unsigned long nSize, [out] unsigned long nError) ; 
// param nPos: desired position 
// param nError: errorcode 
// returns: new position 

unsigned long 5eekPos([in] unsigned long nPos, [out] 

unsigned long nError) ; 
// param nSize: new filesize 
// param nError: errorcode 

Void sGtSize([in] unsigned long nSize, [out] unsigned 

long nError) ; 
// param nByteOffset: where to start locking 
// param nBytes: how many bytes to lock 
// param nError: errorcode 
// returns: success 

boolean lockRange ( [in] unsigned long nByteOffset, [in] 
unsigned long nBytes, [out] unsigned long nError); 
// param nByteOffset: where to start unlocking 
// param nBytes: how many bytes to unlock 
// param nError: errorcode 
// returns: success 

boolean unlockRange ( [in] unsigned long nByteOffset, 
[in] unsigned long nBytes, [out] unsigned 
longnError) ; 

} ; } ; 
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TABLE 204.: INTERFACE XRmFSys 



{ 

struct FileStatMembers 
1 

unsigned long nError; 
unsigned long nKindFlags; 
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unsigned long 

string 

string 

unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
}; 



nSize; 

aCreator ; 

aType ; 
aDateCreated; 
aTimeCreated; 
aDateModif ied; 
aTimeModif ied; 
aDateAccessed; 
aTimeAccessed; 



typedef sequence< string, 1 > DirEntrySequence; 
typedef sequence< FileStatMembers, 1 > 
FiieStatSequence; 
typedef sequence< unsigned long, 1 > FSysSortSequence; 

interface XRmFSys : com: :sun: :star: :uno: :XInterface 
{ // interface 

boolean isCaseSensitive ( [in] string aDirEntry) ; 
string tempName ([in] string aDirEntry, [in] unsigned 
long eKind) ; 

boolean toAbs ( [in] string aDirEntry, [out] string 
aResult) ; 

boolean toRel ( [in] string aDirEntry, [out] string 
aResult) ; 

boolean toRelRel ( [in] string aDirEntry, [in] string 

aRelative, [out] string aResult) ; 
boolean makeShortName ( [inout] string aDirEntry, [in] 

string aLongName, [in] unsigned long nCreateKind, 

[in] boolean bUseTilde, [in] unsigned long 

nStyle) ; 

unsigned short" scan ( [in] string aDirEntry, [out] 
DirEntrySequence aOirEntryList, [out] 
FiieStatSequence aFileStatList, [in] 
FSysSortSequence aSortLst, [in] string aNameMask, 
[in] unsigned short nAttrMask, [in] boolean 
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bFillFileStatList) ; 
boolean update ( [out] FileStatMembers aFileStat, [in] 

string aDirEntry, [in] boolean 

bAccessRemovableDevice) ; 
unsigned long queryDislcSpace ( [in] string aPath, [out] 

unsigned long nFreeBytes, [out] unsigned long 

nTotalBytes) ; 
string getDevice ( [in] string aDirEntry) ; 
string getVolume ( [in] string aDirEntry); 
unsigned long getPathStyle ( [in] string aDevice) ; 
boolean hasReadOnlyFlag ( ) ; 

boolean getReadOnlyFlag ( [in] string aDirEntry); 
boolean exists { [in] string aDir, [in] unsigned long 
nAccess) ; 

boolean first ( [inout] string aDir) ; 

boolean find ( [in] string aDirEntry, [in] string 

aPfad, [in] char cDelim, [out] string aResult) ; 
boolean setCWD { [in] string aDir, [in] boolean 

bSloppy) ; 

boolean maJceOir ( [in] string aDir, [in] boolean 
bSloppy) ; 

long setReadOnlyFlag ( [in] string aDirEntry, [in] 
boolean bRO) ; 

void setDateTime ( [in] string aFileName, [in] unsigned 
long nDate, [in] unsigned long nTime) ; 

unsigned long moveTo ( [in] string aFromDir, [in] 
string aXoDir) ; 

unsigned long kill ( [in] string aFromDir, [in] unsigned 
long nActions); 

}; 

}; 



[1 256] Table 94 ts one embodiment of interfaces XSoundCallBack and XRMSound that are included in one embod- 
iment of lightweight component 230. These interfaces are used when a runtime environment component needs to play 
sounds on user device 102i. 
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TABLE 205.: INTERFACES XSoundCallBack and XRMSound 



{ 

// SoundSequehce 

typedef sequence< byte, 1 > SoundSequence; 

// SoundCallback 

interface XSoundCallback : 

com: : sun: : star : :uno: iXInterface 

{ 

[oneway] void Notify ( [in] unsigned short 

nNotif ication, [in] unsigned long nError ); 

); 

// XRmSound 

interface XRmSound : com: : sun: : star: :uno: rXInterf ace 
{ 

[oneway] void Create { [in] XSoundCallback 

XSoundCallback ) ; 
unsigned long Transfer { [in] unsigned long nExtraData, 

[in] SoundSequence aData, [in] string aFileName ); 
[oneway] void SetStartTime ( [in] unsigned long 

nStartTime ) ; 

[oneway] void SetPlayTime{ [in] unsigned long nPlayTime 
) ; 

[oneway] void SetLoopMode( [in] boolean bLoop ); 
[oneway] void ClearError ( ) ; 
[oneway] void PlayO; 
[oneway] void Stop ( ) ; 
[oneway] void Pause (); 
); 
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10 



[1 257J Table 95 is one embodiment of interface XRmStatus thai is included in one embodiment of lightweight com- 
ponent 230. This interfaces is used when a runtime environment component needs the status of user device 102t, 



TABLE 206, 



INTERFACES XRmStatus 



20 



25 



30 



35 



40 



interface XRmStatus : com: : sun: : star : :uno: :XInter face 
[ 

unsigned long GetRemoteVersion ( ) ; 
unsigned long GetSystemType () ; 
unsigned long GetSystemCharSet ( ) ; 

void ShowError{ [in] string aMsg, [in] unsigned short 
nCode ) ; 

void ShowWarning( [in] string aMsg, [in] unsigned short 
nCode ) ; 

void Showlnfo( [in] string aMsg, [in] unsigned 
short nCode ) ; 
void Quit ( ) ; 
}; 
}; 



45 



50 
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[1258] Those skilled in the art will readily understand that the operations and actions described herein represent 
actions performed by a CPU of a computer in accordance with computer instructions provided by a computer program. 
Therefore, lightweight component 230 may be Implemented by a computer program causing the CPU of the computer 
to carry out instructions representing the individual operations or actions as described hereinbefore. The computer 
instructions can also be stored on a computer-readable medium, or they can be embodied in any computer-readable 
medium such as any communications link, like a transmission link to a LAN, a link to the internet, or the like. 
[1259] Thus, lightweight component 230 can be implemented by a computer program comprising computer program 
code or application code. This application code or computer program code may be embodied in any fomi of a computer 
program product. A computer program product comprises a medium configured to store or transport this computer- 
readable code, or in which this computer-readable code may be embedded. Some examples of computer program 
products are CD-ROM discs, ROM cards, floppy discs, magnetic tapes, computer hard drives, servers on a network, 
and carrier waves. The computer program product may also comprise signals, which do not use carrier waves, such 
as digital signals transmitted over a networic (including the Intemet) without the use of a canier wave. 
[1 260] The storage medium induding the applications/services executed on a server may belong to server computer 
system 100 itself. However, the storage medium also may be removed from server computer system 100, The only 
requirement is that the applications/services are accessible by server computer system 100 so that the application/ 
service corresponding to lightweight component 230 can be executed by server 100. 
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[1 261] Herein, a computer memory refers to a volatile memory, a non-volatile memory, or a combination of the two 
in any one of these devices. Similarly, a computer input unit and a display unit refer to the features providing the required 
functionality to input the Information described herein, and to display the infonnation described herein, respectively, in 
any one of the aforementioned or equivalent devices. 
5 [1 262) While the present invention has been explained in connection with certain embodiments thereof, other em- 
bodiments will be apparent to those skilled in the art from consideration of the specification and practice of the embod- 
iment of the present invention disclosed therein. It is Intended that the specification and examples be considered as 
exemplary only, without limiting the spirit and scope of the invention. 

[1263] In the following, further embodiments of the Invention will be described with respect to figs. 11 - 22. 
10 [1 264] The embodiments may be implemented in a software system for providing the functionality (i.e. the services) 
of runtime environment components from a server computer system via a network to one or several client computer 
systems. 

[1265] The software system consists of two parts, one of them being executed on a client, the other residing and 
being executed on the server. The part on the server platform makes up the runtime environment comprising a plurality 

15 of runtime environment components which are able to provide services. Furthermore, the part on the sen/er provides 
the necessary communication tools in order to communicate with the client. The other part, being executed on the 
client, performs mainly the communication between the client requesting a aintime environment component service 
and the part being executed on the server which renders the mntime environment component service requested. The 
server's part of the software system Is by far larger in size than the clients part thereof. This latter part is refen-ed to 

20 as the 'lightweight component. A typical size of the software system's part on the server may be 50 to 100 Megabyte 
(e.g.: an office software package), whereas the lightweight component on the client may have a typical size of 400 
Kilobyte, and may utilize only little system resources (CPU power, memory). 

[1 266] The small size of the lightweight component makes it attractive to download it within very short time from the 
server to a client when the con-esponding runtime environment component service is actually needed. Then, via the 
25 lightweight component, the client has access to all the services presented by the runtime environment components 
hosted on the server. 

[1 267) Th4 lightweight component provides an application programming interface (API) for any application program 
the implementation of which on the client is allowed by an implementation framework on the server. Two types of 
lightweight components are explained in the following, one being a standard component (refening to Figures 11 to 14), 

30 the other being a component rendering visual functionality (refening in particular to Figures 15 to 19). 

[1 268] Cbrtiputer Software programs and parts thereof, which are called during execution of other computer software 
programs or parts thereof, are referred to as runtime environment components. The functionality provided by these 
runtime environment components to calling software programs or parts thereof are referred to as runtime environment 
component services. In many cases, runtime environment components have a very large size. For example, office 

35 suites comprising drawing programs and wordprocessors as well as other tools may have sizes of 50 to 1 00 Megabyte 
which renders a distribution over the Intemet difficult. The runtime environment components may be implemented in 
any suitable form. They may consist of compiled software program code to be executed or of script code In any pro- 
gramming language to be interpreted before execution by a compiler Runtime environment components are typically 
stored and adrriinistreted on a server. 

40 [1 269] The runtime environment component services, that means the functionalities provided by runtime environment 
components, which are, for example, stored on a server, are made available for use in software programs to be executed 
on, for example, clients without integrated them Into these software programs and without distributing them together 
with these software programs to the place of execution, for example, the clients. 

[1 270] Further, functionality of the runtime environment components should is made available for all kinds of clients 
45 whether they are powerful enough for storing or executing the runtime environment component or not. Further, the 
user of a client is not charged with the problem whether a specific runtime environment component is available on his 
client or not. 

[1271] Reference Is made to Fig. 11, which illustrates the communication tietween the server 111 and an arbitrary 
number of clients 1 12A, 1 1 2B which are connected via communication networic 1 13. The server 111 presents the runtime 
50 environment component services to the clients 112A, 11 2B. Server 111 hosts components 1101, 1102, 1103, 1104. 
1105, 1106 of the runtime environment as well as a component 1100 for communication with the clients 112A, 112B 
via a network 113. The networic 113 Is here assumed to be the Intemet, although any other networic may be used as 
well. Each client 112A, 1128 Is adapted to execute (at least) one software program 1250. 

[1272] On each of the clients 112A, 112B a lightweight component 1210 is implemented, which provides services of 
55 the runtime environment components 1101, 1102, 1103, 1104, 1105, 1106 hosted on server 111 to a software program 
1250 running on the clients 112A, 112B. The communication with server 111 Is perfomned by the communication com- 
ponent 1200 via the network 113. It is to be noted that the lightweight component 1210 may initially not be available 
on the clients 112A, 112B. In this case, the lightweight component 1210 maybe downloaded on the clients112A, 112B, 
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for example, from the server 111 upon the first request for runtime environment component services which are acces- 
sible by means of the lightweight component 1210. 

[12731 It is assumed that on the clients 112A. 112B a software program 1250(e.g.: an Internet browser) is executed. 
[1274] Whenever the software program 1250 calls for a runtime environment component, for example an API 1101 
5 for providing a mathematical function, the lightweight component 1210 receives this cail. The lightweight component 
1210 then transforms this call into a request and transmits it via the communication component 1200, the network 113 
and the communication component 1100 to the server 111, where the API component 1101 called for is residing. 
[1275] Fig. 12 to 14 now illustrate the processing for presenting / providing the runtime environment component 
services in more detail. 

10 [1276] Referring to Fig. 12. the lightweight component 1210 receives a call for an API component 1101 from the 
software program 1250 mnning on the client 112A. With the call, data (e.g. arguments) necessary for performing the 
requested mntime environment component service of API component 1101 is received. The lightweight component 
121 0 transforms the received call into a request to be transmitted over the network 1 1 3 to.the server 1 1 1 which actually 
hosts the runtime environment, including the now requested API component 1101. 

1 5 [1 277] The transmission of the request over the network 1 1 3 is perfomied according to a predetemiined transm ission 
protocol. The transmitted request contains the data (e.g. arguments) from the calling software program 1250 for being 
processed by the API component 1101. If the network 113 is publicly accessible, the transmission may be encrypted 
according to known technologies. Further, digital signatures can be used to provide certification of the request mech- 
anism being established on the client for this runtime environment component sendees system. 

20 [1278] The request is received by the server 111 on which the appropriate communication component 1100 is exe- 
cuted. The communication component 1100 transforms and decrypts (if necessary) the transmitted request, performs 
digital signature processing, and accesses the requested API component 1101 implementing the desired mathematical 
function. This API component 1101 is executed on the server 111, whereby the data (e.g. arguments) received with 
the request are processed. The result thereof is encrypted (if necessary) by the communication component 1100 and 

25 transmitted from the server 111 back to the client 112A. 

[1279] The lightweight component 1210 on the client receives and re-transforms the result (and decrypts it, if nec- 
essary) and provides the result to the software program 1250 having called for the service of the API component 1101. 
[1280] Thus, the lightweight component 1210 on the client 112A delegates calls to the API component 1101, which 
may be part of an implementation framework on the sender 111 . The lightweight component 1210 operates hidden to 

30 the calling software program of the client 112A. The called mntime environment component 1101 is executed on the 
server 111. However, the calling software program 1250 on the client 112A does not notice whether the execution of 
the runtime environment component 1101 is local, i.e. on the client 112A, or remote, i.e. on the server 111. The calling 
software program 1250 does not need to be modified for the use with the lightweight component 1210, since, the call 
for a mntime environment component is 'intercepted' and transformed into a suitable request to the server 111 by the 

35 lightweight component 1210, according to the invention. 

[1281] On the other hand, local services available on the client 1 1 2A, including devices like printers and local storage, 
can also be utilized by the runtime environment components on the sender 11 1 , in a transparent manner Transformation 
of the call of the software program 1 250 to the lightweight component 1210 and re-transfomiation of the result received 
from the sender 111 are performed "on the fl/*, 

<o [1 282] Fig. 1 3 illustrates the implementation of the lightweight component 1210. As mentioned above, the component 
1 21 0, which is necessary for transforming the call can be kept relatively small. It can have a small installation size and 
low usage of resources compared to the runtime environment components on the server 111 . 
[1 283] Fig. 14 exemplary illusfrates the transparent access of a mntime environment component via an object com- 
ponent model. The object component model handles calls by marshaling requests for mntime environment component 

45 services through stub objects 1 200' on the client 1 12A and fransmitting it over the network 11 3 to the server 111. There, 
the requests are unmarshaled through proxy objects 1100'. 

[1284] The stub objects 1200' and the proxy objects 1100* are generated dynamically, for example, by the commu- 
nication component 1200 and by the communication component 1100, respectively. Therefore, a caller does not have 
to implement the stub objects 1200' and the proxy objects 1100*. 
50 [1 285] Marshalling of a request is, in the present context, understood as the process of embedding a request for a 
mntime environment component service in a bit sfream for fransmission over a network. The unmarshalling is the 
inverse process of the marshalling. 

[1286] The fransmission concept through stub and proxy objects is described in more detail in the Annex. 
[1287] The stub / proxy object component model used here implies that a lightweight component is able to access 
55 any arbitrary mntime environment component 1101, 1102,1103. 1104, 1105, 1106 available on the server 111. as if it 
resided locally on the client 112A. 

[1288] Referring to Figures 15 to 17, a further embodiment of a lightweight component 1210 is explained. The com- 
munication between the server 111 and the client 112A is performed via the networic 113 by the respective communi- 
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cation components 11 00 on the server 1 1 1 . and 1 200 on the client 1 1 2A. The same encryption / decryption mechanisms 
as indicated atwve may be applied. In addition to the basic generic lightweight component 1210 as described in con- 
nection with Figures 11 to 14, the lightweight component 1210 may include the ability to perform graphic interaction 
and to manage user interaction. In the following, such a component is referred to as a visual lightweight component. 
Such a graphic interaction may comprise drawing visual contents on the client 11 2A. for example, on a screen of a 
client laptop. Again, as described above, the main part of the processing is burdened on the runtime environment 
component residing and running on the server 111. 

[1 2891 The protocol which may be used for transmitting graphical requests between the client 1 12A and the server 
111 is the Rernote Visualization Process protocol (RVP). RVP is a high level definition of a graphic device defined as 
a set of interfaces. RVP Is based completely on a component infrastructure. This gives RVP the ability to map func- 
tionality which a client system is unable to support, to a service component on the server side emulating this functionality. 
[1 290) The graphical environment may communicate with the lightweight component 1210 through the Java Abstract 
Window Toolkit layer {AWT). AWT stands for the definition of the graphic and user interface layer for the Java language. 
It is defined as a set of Java classes and interfaces which are mapped to the concrete implementation on different 
platforms. AWT is part of the standard Java environment. 

[1 291 1 The service component on the server side uses a VCL implementation as drawing engine. VCL (Visual Class 
Library) is a C++ class library , It provides similar to the AWT a set of classes and interfaces to build graphical appli- 
cations on different platforms. For every platfomn there is a concrete implementation of VCL. For the lightweight visual 
components, VCL provides a special implementation, which ti-ansmits all graphical requests for drawing over the net- 
woric to a client side, where these requests are intercepted and mapped to a platform dependent graphic layer, which 
is here AWT. 

[1 292] Again, the implementation framework on the server handles drawing and user interaction transparently to the 
component. 

[1293] Fig; 15 illustrates RVP event processing. The visual lightweight component 1210 is embedded in a graphical 
environment, the graphical environment comprising a display software program 1250 with a graphical user interface 
(GUI), The graphical user interface is referred to as a panel. An example of an implementation is a Java bean which 
is embedded in an HTML page and rendered by a browser. This Java bean represents a view (in a window) of an office 
application component (e.g. StarOffice Writer) or another visual office component. 

[1 294]^ > An event from the graphical environment is passed to tiie AWT 1 260, and then interpreted by the RVP protocol 
layer, which performs communication between the client visual lightweight component 1210 and the remote office 
mntime environrrient component implementation 1110 on the server platfomi 111. From RVP 1220 the event is mar- 
shaled by communication component 1200 and transmitted to the sen/er 111 . There, it is unmarshaled and passed to 
the RVP 1120 by communication component 1100, and dispatched by the VCL layer 1140. 

[1295] The njntime environment component 1110 receives the event. After the event is dispatched, the component 
1 1 1 0 is able to react to the event. 

[1296] Fig.:i6 illustrates tiie transmission of the response of the component 1110 on the server 111 back to the 
requesting client 112A. The requested service is here a drawing functionality which is implemented by RVP drawing. 
The office cornponent (e.g. the StarOffice Writer) 1110 is able to draw on a panel within software program 1250 of the 
client 112A using the same mechanism as described above. The component 1110 uses the VCL 1140 as a drawing 
engine. The operations are ti-ansmitted through VCL 1140, RVP 1120 and communication component 1100 on the 
server 111 to the client 112A. Client 112A receives the operations and passes them to the AWT 1260 which is able to 
draw on the panel of the client 112A directly. 

[1 297] Fig. 1 7 illustrates accessing an API as a runtime environment component on the server 1 1 1 by the client 1 1 2A. 
The visual lightweight component 1210 is, in the example described in Fig. 15 and Fig. 16, still able to access trans- 
parentiy the full functionality of an API 1104 provided by tiie office component 1110. The request of the lightweight 
component 1210 for API 1104 is handed over to the office component 1110 through the communication component 
1200 on the client 112A and the communication component 1100 of the sender 111. Herein, the request for the API 
1104 generated by the lightweight component 1210 may bypass RVP 1220 and AWT 1260 on the client 112A and 
likewisei RVP 1120 and VCL 1140 on the server 111, if not drawing services are requested. The latter would be tiie 
case, for example, if AP1 1104 would provide calculation services. In order to have the request bypass the mentioned 
components the lightweight component 1210 must decide that these components shall be bypassed. This decision 
can be made by the lightweight component 1210 based on the call of the AP1 1 1 04 received from the software program 
1 250 and the information that the AP1 1 1 04 does not provide drawing services. This infomriation will regularty be present 
in ttie lightweight component 1210, since it has information about all runtime environment components being available 
on the server 111 anyway since it has to request their services and receive their responses. However, if necessary 
the office component 1110 may also react to the requestfor API 1104 by drawing via RVP 1220 directly on the panel 
of client 11 2A. 

[1298] An exemplary scenario for ttie latter might be the following: a user on client 112A editing a text document 
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displayed in his browser whishes to change the font size to 1 0 points throughout the whole document For this purpose, 
the client 11 2A uses the API 1104 to change all fonts throughout the whole document to a size of 10 points. In this 
case, the office component 1110 running on the server 111 re-calculates the display of the document, renders the 
document remotely, and draws the document on the client 112A through the RVP 1120 and RVP 1220. 

5 [1 299] However, if the user on client 1 1 2A changes the font size only for newly input text lines, the cun-ently displayed 
document does not change, thus there is no need to re-draw the whole document on the client 112A. The event of 
changing the font size is passed via RVP 1 1 20 to the office component 1 1 04 and forces new rendering of the document 
on the server 1 11 . Since no re-drawing of the document on the client 112A is needed, the lightweight component 1210 
does not have to take any further action. 

10 [1300] The participating components to create a Java bean lightweight component in the frame of the office appli- 
cation program package StarOffice used as a runtime environment component are shown in Fig. 1 8. An accompanying 
sequence diagram is supplied in Fig. 19, The figures are reduced to show only needed relations and methods to 
illustrate this specific process. A StarOfficeBean represents a common java bean which is derived from a java panel. 
It resides on the client as the single instance Connector, which is responsible for maintaining connections to the remote 

15 machine. All client beans share one connection per user and server. The OCiientFactory created by the Connector \s 
also located at the client 112A. This enables the remote Office Component to create elements which are specific to 
the client 112A. Examples for these items range from a simple frame window to a printer device handled locally. Next 
the Connector establishes a connection to the remote machine and starts the login process. If succeeded the server 
111 starts a StarOffice session remotely and the Con/iecfor confirms the session with StartQ. The task of the remote 

20 MultiServiceFactory created by the RVP Connection instance is to create needed instances on the remote machine. 
Then a local ORmFrameWmdow is created and passed together with a reference of the OClientFactory to the remote 
StarOffice instance to be able for local dispatching and drawing. By calling initializeQ on the remotely created Java- 
BeanFrame all actions are done and the process of creating a StarOfficeBean is completed. 
[1301] Unlike components like CORBA objects, lightweight components 1210 do not have any additional code for 

25 accessing the implementing object. Also the size of a lightweight component 1210 does not increase with the number 
of accessed runtime environment components of the Implementation server framework. This introduces the ability to 
offer components which expose only services designed fora special purpose and hide complexity of the implementation 
framework. 

[1302] By applying the invention, it is possible to include for example full word processing functionality provided by 
30 the server 111 into any other application program 1250 running on the client computer 112A. 

[1303] Special purposes may be applications designed for l>eing executed on particular clients like handheld com- 
puters or mobile telephones, where storage and processing capabilities are particularty limited. Nevertheless, the whole 
functionality of the framework is still accessible. 

[1304] Furthermore, when adding new runtime environment components to the server 111 , no modification on the 
35 client side is necessary. Through the concept of lightweight components, a new runtime environment component on 
the server is immediately callable by the client. The components are based on a generic lightweight component which 
is able to communicate with the implementation framewori< via the object component model. 
[1305] Fig. 20 refers to an example for using the present invention. In this example a setup is used as described in 
Fig. 15 to 17. Therefore, reference numerals also relate to components which are presented and described in more 
40 detail in connection with Fig. 1 5 to 1 7. However, the method according to Fig. 20 does not correspond to the methods 
described along Fig. 15 to 17. 

[1306] In this example, a user utilizes his computer system as a client 112A. This client 112A includes a screen on 
which the user can edit and process a text document. The client 112A includes text processing software 1250 with a 
limited scope of functionality and a lightweight component 1210 which corresponds to comprehensive services offered 
45 by an office suite software package 1110 located as runtime environment components on a server 111 to which the 
client 112A is connected via a network 113. 

[1 307] For the purposes of this example the user edits a text document on the screen of the client 1 12A and changes 
the font size of the text. In order to do this he inputs his commands via a suitable input device of the client 112A, for 
example, a keyboard. In step 2010 the text processing software 1250 on the client 112A requests the service "font 

50 change" from the lightweight component 1210. The lightweight component 1210 receives this request in step 2020. In 
step 2030 the lightweight component 1210 marshals the request and transmits it via the communication component 
1200 in client 112A to the communication component 1100 of the server 111 via the networic 113. 
[1308] The sender 111 unmarshals the request and calls the mntime environment component 1110 in step 2040. In 
the next step 2050 the component 1110 starts processing the "font change" request. It will detemiine in step 2060 if a 

55 re-drawing of the text document on the screen of the client 112A is necessary due to the requested font change. 

[1 309] If not, the service component 11 10 will immediately produce a result to the request in step 2080. A re-drawing 
may not be necessary, if the user wants the font change to be effective exclusively for further input into the text docu- 
ment. In this case the result to be provided by component 1110 could be a return code to the software program 1250 
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which tells the software program 1250 that further input into the text doojment will be processed with the new font on 
the screen of the client 112A. 

[1310] If yes, for example, if the font shall be changed for the whole text document, the component 1110 renders a 
new graphical presentation of the text document in step 2061. Then, in step 2062. the output operations for the reali- 

5 zation of the graphical presentation are given to the VCL 1140 by the component 1 110, In step 2063 it will be decided 
by VCL 1140 whether the output operations have to be carried out in a visible area. e.g. on a screen. 
[13111 If this is not the case, for example, if the text document with the font changed throughout its entire scope 
would only be stored as a data file but not shown on the screen of the client 112A. the result would be created in step 
2090 by VCL 1140. This result would be the text document in the new form. No display on the screen of the client 1 12A 

10 would be envisaged in this case. 

[1312] If this is the case, for example, if the text document shall be displayed on the screen of the client 112A. the 
"change fonf request realized by VCL 1140 is transmitted to RVP 1120 in step 2064. This realized request is then, in 
step 2065, marshaled and sent via communication component 1100 of server 111, via the network 113 and via the 
communication component 1200 of the client 11 2A to the lightweight component 1210 on the client 112A. In step 2066 

15 the lightweight component 1210 unmarshals the realized request. In step 2067 the request Is translated into an AWT 
request. This AWT request is transmitted in step 2068 from the lightweight component 1210 via the RVP 1220 to the 
AWT 1260. In step 2069 the AWT 1260 executes the transmitted AWT request. Finally, in step 2070 the result will be 
transmitted to the software program 1 250 so that the text document will be drawn on the screen of the client 11 2A with 
the new font size. 

20 [1 313] Fig. 21 illustrates a non-visual lightweight component. Non-visual means that the user of the client on which 
the lightweight component is located does not receive any hints as to Its presence. He does not see it and he can also 
not interact with it directly. 

[1314] In Fig. 21 a client 2110 is shown with a screen showing, on the left, a tree-like representation of data files 
betow a window, and, on the right, information given about a certain text document which was selected by the user by 
25 means of the tree-like representation of data files. The client 2110 is connected via networic 2120 to a server 2130 
which has access to a text processing software program as runtime environment component 2140. This component 
2140 has in turn access to a storage medium 2150 and to a library 2160. 

[1 31 5] If a user of the client 2110 wants Xo obtain information, for example, number of words and lines, author and 
date of this version, about a text document chosen from the tree-like representation of data files, he enters his request 

30 via an input device of the client 2110, for example, a keyboard of the client 2110. Then, the non-visual lightweight 
component on the client 2110 will contact, as described above, via the networi< 2120 the sender 2130 and ask for the 
services providing the Information requested by the user from the runtime environment component 2140. The result 
provided by the component 2140 will then be re-transmitted to the client 211 0 so that the desired information - number 
of words and lines; author and date of this version of the selected text document - can be displayed on the screen of 

35 the client 2110. The lightweight component remains non-visual to the user of the client 2110. 

Fig. 22 in contrast shows an example of a visual lightweight component, that means a lightweight component with 
which the user may interact, but which will at least be recognized by the user in some situations. 
[1316] A client 2210 includes a visual lightweight component. The client 2210 Is connected via network 2220 with 
the server 2230. which in turn has access to the runtime environment component 2240 connected to storage medium 

40 2250 and data base 2260. 

[1317] In this example, a user of the client 2210 edits a text document on the screen of the client 2210, as shown 
in Fig. 22 on the right, besides the above described window and tree-like representation of data files. The shown screen 
representation of the text document shows in the right middle position a small window with which the user may ma- 
nipulate the displayed text document. This window represents the lightweight component. Here, the user may directly 

45 interact, via the window presentation, with the lightweight component, which is therefore referred to as a visual light- 
weight component. 

[1 318] If the lightweight component is activated by a user interaction it may contact, as descritied above, the server 
2230 and thereby the runtime environment 2240, which may provide a service requested by the user by his interaction 
from the client 2210. 

50 [1319] Comparing a non-visual and a visual lightweight component as above described, it may be advantageous to 
use a non-visual lightweight component for processing requests which do not require particular operations for their 
fulfillment, in particular, no drawing operations on a screen of a client. In this case, the non-visual lightweight component 
may provide the response to the request more quickly than a visual lightweight component, since, for example, drawing 
operations are not processed at all ; they are not only ignored by the client after having been processed with great efforts. 

55 [1 320] In the following, further embodiments for remote control and interaction with a run time environment compo- 
nent will be described. 

1) A method for presenting a runtime environment component service by a first computer system to a second 
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computer system over a communication network, said method being performed by said first computer system and 
comprising: 

generating a user interface infrastructure, on said first computer system, to receive graphic user interface 
5 events from said second computer system and to send remote graphic user interface commands to said second 

computer system; and 

using said user interface infrastructure to initialize said runtime environment component service wherein said 
runtime environment component service sends graphic user interface commands to said user interface infra- 
10 structure. 

2) The method of 1 ) further comprising: 

receiving by said user interface infrastructure a remote input action event via said communication network, 
said remote Input action event being generated in said second computer system by a lightweight component cor- 
15 responding to said runtime environment component service. 

3) The method of 2) further comprising: 

transmitting an input event to said mntime environment component service by said user interface infrastruc- 
ture in response to said remote input action event. 

20 

4) The method of 3) further comprising: 

processing said input event by said runtime environment component service. 

5) The method of 4) further comprising: 

25 generating a graphic user interface command to said user Interface infrastructure by said runtime environ- 

ment component service. 

6) The method of 5) further comprising: 

transmitting a remote graphic user interface command to said lightweight component by said graphic user 
30 interface infrastructure In response to said graphic user interface command. 

7) A method for presenting a runtime environment component service by a first computer system to a second 
computer system over a communication network, said method being performed by said first computer system and 
comprising: 

35 

receiving a remote input action command for a runtime environment component service via said communica- 
tion network, said remote input action command being generated in said second computer system by a light- 
weight component corresponding to said mntime environment component service; 

40 transmitting a local input action command to said runtime environment component service in response to said 

remote Input action command; 

processing said local input action command by said runtime environment component service; 

45 generating a local output command by said runtime environment component service for a graphical user in- 

terface; and 

transmitting a remote output command to said lightweight component in response to said local output com- 
mand. 

50 

8) The method of 7) wherein said runtime environment component service is In an office application suite. 

9) The method of 7) wherein said method further comprises: 

receiving said local output command by a local window object and in response generating said remote output 
55 command by said local window object 

1 0) The method of 7) wherein said method further comprises: 

receiving said remote input action command by a local window object and in response generating said local 
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10 



input action command by said local window object 

11) The method of 9) wherein said method further comprises: 
receiving said remote input action command by said local window object, and in response generating said 

local input action command by said local window object. 

12) The method of 10) wherein said remote input action command is a user interface event. 

13) The method of 11) wherein said remote input action command is a user interface event 

14) A method comprising: 

receiving a command by a service executing on a computer system to create an infrastmcture for executing 
a runtime environment component sendee, wherein said command is from a component executing on a user 
15 device; and 

issuing an instmction to create an instance of a remote frame window on said user device. 

15) The method of 14) further comprising: 

20 generating an instance of a local window on said computer system by said sers/ice. wherein said local window 

issues remote instructions to said remote window frame in response to instructions from said runtime environment 
component service. 

16) The method of 15) further comprising: 

25 querying said remote frame window by said local window to determine properties of said remote frame win- 

dow. 

1 7) The method of 1 5) further comprising: 

generating, on said computer system, a local frame for said local window. 

30 

18) The method of 17) further comprising: 

receiving, by said local frame, a command from said user device to load a document. 

19) The method of 18) further comprising: 

35 issuing, in response to said command to load a document, a command by said local frame to said runtime 

environment component service to create an instance of a mntime environment component service window on 
said computer system. 

20) The method 19) further comprising: 

^0 issuing a command by said local frame to said runtime environment component service to load said document 

in said runtime environment component service window. 

21) The method of 20) further comprising: 

issuing a command from said runtime environment component service to said local window to display said 
•^45 docurpent 

22) A method for enabling a user device to run a runtime environment component on another computer, said 
method comprising: 

50 running a browser on said user device; and 

running a lightweight component within said browser, wherein said lightweight component receives user input 
actions on said user device and generates corresponding user interface events to said another computer for 
processing by said runtime environment component 



55 



23) The method of 22) further comprising: 

downloading lightweight component into said user device. 
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24) A computer program product comprising computer code comprising: 
a remote frame window class comprising: 

a remote output device interface; and 
a remote frame window Interface. 

25) The computer program product of 24) wherein said computer code further comprises: 

a t>ean frame class comprising a frame Interface. 

26) The computer program product of 24) wherein said computer code further comprises: 
a bean window class comprising: 

an event handler interface; and 
an window peer Interface. 

27) The computer program product of 24) wherein said computer code further comprises: 

an abstract windowing toolkit. 

28) A computer program product comprising computer code for a method for presenting a runtime environment 
com |3onent service by a first computer system to a second computer system over a communication network, said 
method being performed by said first computer system, said method comprising: 

generating a user interface Infrastructure, on said first computer system, to receive graphic user Interface 
events from said second computer system and to send remote graphic user interface commands to said second 
computer system; and 

using said user interface infrastructure to initialize said runtime environment component service wherein said 
runtime environment component service sends graphic user Interface commands to said user Interface Infra- 
structure. 

29) A computer program product comprising computer code for a method for presenting a runtime environment 
component service by a first computer system to a second computer system over a communication networic, said 
method being performed by said first computer system and comprising: 

receiving a remote input action command for a runtime environment component service via said communica- 
tion networic, said remote input action command being generated in said second computer system by a light- 
weight component corresponding to said runtime environment component service; 

transmitting a local Input action command to said runtime environment component service in response to said 
remote input action command; 

processing said local input action command by said runtime environment component service; 

generating a local output command by said runtime environment component service for a graphical user in- 
terface; and 

transmitting a remote output command to said lightweight component in response to said local output instruc- 
tion, 

30) A method for presenting a runtime environment component service by a first computer system (1 11 ) to a second 
computer system (112A) over a communication network (113), said metiiod being perfomied by said first computer 
system (111), and comprising the steps of: 

a) receiving a request for a runtime environment component service via said communication network (113), 
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said request being generated in said second computer system (112A) by a lightweight component (1210) 
corresponding to said njntime environment component service, 

b) accessing a runtime environment component (1101, 1102, 1103, 1104, 1105. 1106, 1110) being able to 
provide said requested runtime environment component service, 

c) executing said runtime environment component (1101, 1102, 1103, 1104, 1105, 1106, 1110) on said first 
computer system (111) for producing a result according to said received request for a runtime environment 
component service, 

d) transmitting, over said networic (113), a response comprising said result to said second computer system 
(112A). 

31) A method for providing a runtime environment component service from a first computer system (111) over a 
communication network (113) to a second computer system (112A), said method being executed on said second 
computer system (11 2A). and comprising the steps of: 

a) generating a request for a runtime environment component service by means of a lightweight component 
(1210) of said second computer system (112A), wherein said lightweight component (1210) con-esponds to 
said runtirrie environment component service, 

b) transmitting said request for said runtime environment component service to said first computer system 
(111) over said communication network (113), and 

c) receiving a response comprising a result according to said requested runtime environment component serv- 
ice, said result being produced by a runtime environment component (1101, 1102, 1103, 1104, 1105, 1106, 
1110) executed on said first computer system (111) and transmitted with said response by said first computer 
systeim (111) over said network (113). 

32) A method according to any one of 30). 31). wherein said lightweight component (1210) has a smalt size Is 
compared to the total size cs in bytes of the at least one runtime environment components (1101, 1102, 1103, 

1104, 1105, 1106. 1110) providing a service corresponding to said lightweight component (1210) including any 
auxiliary software programs needed to execute said mntime environment components (1101, 1102. 1103, 1104. 

1105. 1106, 1110). 

33) A method according to 32), wherein said size Is is equal or less than ten percent of the total size cs. 

34) A method according to any of 30) - 33). wherein said lightweight component (1210) may be downloaded from 
said first computer system (111) to said second computer system (112A) over said network (113) in a time t equal 
or less than (8 N / Cg) + 1^ . wherein N is the total size in bytes of the at least one mntime environment component 
( 1 1 0 1 . 1 1 02, 1 1 03 , 1 1 04 , 1 1 05, 1 1 06, 1 1 1 0) providing a service corresponding to said lightweight component (1210), 
Cb is the average bandwidth of the network (113), and t^ is the total time needed to initialize said runtime environ- 
ment components (11 01, 1102, 1103. 1104, 1105, 1106. 1110) providing a service corresponding to said lightweight 
component (1210) in the local environment on said first computer system (111) in which it is embedded. 

35) A method according to any of 30) - 34), wherein said lightweight component (1210) is a non-visual lightweight 
component. 

36) A method according to any of 30) - 35), wherein said lightweight component (1210) may be downloaded from 
said first computer system (111) to said second computer system (112A) over said networic (113) in a time t equal 
or less than ten seconds. 

37) A method according to any of 30) - 36), wherein said lightweight component (1210) is transmitted from said 
first computer system (111) over said networic (11 3) to said second computer system (112A) prior to performing a 
method of any of 1)-36). 

38) A method according to any of 30) - 37), wherein said runtime environment component services comprise at 
least one of the following functions: graphic functions, word processing functions, document editing functions, 
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printing functions. 

39) A method according to any of 30) - 38), wherein said first computer system (111) Is a server system, and said 
second computer system (112A) is a client system. 

40) A method according to any of 30) - 39), wherein said runtime environment components (1101, 1102, 1103, 
1104, 1105, 1106, 1110) comprise at least one application programming interface (API). 

41) A method according to any of 30) - 40). wherein said runtime environment component services comprise output 
services on said second computer system (112A). 

42) A method according to any of 30) - 41), wherein said request for a runtime environment component service is 
transmitted by said second computer system ( 1 1 2A) Into said network ( 1 1 3) by a communication component (1200) 
of said second computer system (112A), and wherein said response of said first computer system (111) to said 
request is transmitted into said network (1 13) by a communication component (1 100) of said first computer system 
(111). 

43) A method according to 42), wherein said communication component (1200) is able to generate a stub object 
(1200') and wherein said communication component (1100) is able to generate a proxy object (1100'). 

44) A method according to any of 30) - 43). wherein said transmitted request complies with a predetermined 
communication protocol. 

45) A method according to any of 30) • 44), wherein said transmitted request comprises identification data of said 
first computer system (111), identification data of said second computer system (112A), identification data of said 
runtime environment component service, and input data to said runtime environment component service. 

46) A method according to any of 30) - 45), wherein said transmitted result comprises identification data of said 
first computer system (111), identification data of said second computer system (112A), identification data of said 
runtime environment component service, and output data of said runtime environment component service. 

47) A method according to one of 30) - 46), wherein said communication network (113) complies with ttie Internet 
protocol http- 

48) A method according to any of 30) - 47), wherein said request and said response are ti^ansmitted over a secure 
channel of said communication network (113). 

49) A method according to any of 30) - 48), wherein said first computer system (111) has access to runtime envi- 
ronment components (1101, 1102, 1103, 1104, 1105, 1106, 1110) which reside on a further computer system. 

50) A method according to any of 30) - 49), wherein said request for said runtime environment component service 
is generated in said second computer system (11 2A) by using a Remote Visualization Process (RVP) (1220) and 
a Absti-act Window Toolkit (1260). 

51) A method according to any of 30) - 50), wherein said request for said runtime environment component service 
is received in said first computer system (111) by using a Remote Visualization Process (RVP) (1120) and a Visual 
Class Library (VCL) (1140). 

52) A method according to any of 30) - 51), wherein said response of said first computer system (111) is ti^ansmitted 
to said second computer system (1 12A) by using a Remote Visualization Process (RVP) (1120) and a Visual Class 
Library (VCL) (1140). 

53) A metfiod according to any of 30) - 52), wherein said response of said first computer system (111) is received 
in said second computer system (112A) by using a Remote Visualization Process (RVP) (1220) and a Absti-act 
Window Toolkit (1260). 

54) A method for presenting runtime environment component services by a first computer system (111) perfomrilng 
the method according to 30), to a second computer system (11 2A) performing the method according to 31). 
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55) Data carrier means containing computer software for perfomning the method according to any of 30) - 54). 

56) A computer system for performing the method according to any of 30) - 54). 

5 57) A set of runtime environment components (1101, 1102, 1103, 1104. 1105, 1106, 1110) for use with a method 

according to any of 30) - 54). 

58) A data base comprising a set of runtime environment components (11 01, 1102. 1103, 1104, 1105, 1106. 1110) 
relating to said runtime environment component services according to any of 30) - 54). 

Abstract of CHAPTER C 

[1 321 J A user device, a first computer system, includes a lightweight component that receives user input actions for 
a runtime environment component that is executing on a second computer system. The lightweight component sends 
15 a remote input action command to a user interface infrastructure that is executing on the second computer system. In 
response to the remote input action command, the user interface infrastructure sends a local input action command 
to the runtime environment component that processes the command, and issues a local output command to the user 
interface infrastmcture that in turn sends a remote output command to the lightweight component on the user device. 
In response to the remote output command, the lightweight component causes an output on the user device. 

20 

CHAPTER D 

[1 322J CHAPTER D describes a method and device for representing data, 
25 Field 

[13231 present invention relates to a method and a system for the individual representation of data, e.g. in the 
network portal system of CHAPTER A. 

30 Background 

[1324] Infonmation requested by a user device naturally needs to be in a format to be understood by this specific 
user device. Therefore, in many instances information is only accessible to a certain group of user devices. For example, 
homepages of individuals or companies provided by a webserver over the internet are generally available only to 
35 specific user devices, namely computer systems supporting the regular homepage data format html. However, the 
access of other user devices to this information may also be desirable. Such user devices may be, for example, hand- 
held computers or mobile phones. 

[1 3251 Unfortunately, the Internet browsers that process and display the HTML homepages typically require over 50 
Megabytes of storage, which is not available on handheld computers or mobile phones. 

40 [1 326] Alternative methods are available, for example, that perniit mobile telephones to send and receive information 
from the Internet. Typically, a program executing on the telephone transmits a URL, or a representation of a URL to a 
server that translates the request, and retrieves the data over the Intemet. The server then converts the retrieved 
content into a format that can be interpreted by the mobile telephone and transmits the data to the mobile telephone 
for display. See for example, U.S. Patent Number 5,809,415 of Rossmann entitled "Method and Architecture for an 

45 Interactive Two-Way Data Communication Network." 

[1327] Another similar approach is described in U.S. Patent No. 5,727,159, entitled "System In Which a Proxy-Server 
Translates Inforrnation Received From the Intemet Into a Form/Format Readily Usable by Low Power Portable Com- 
puters," of Kikinis issued on March 10. 1998. In this approach, a specialized browser must be installed on each device 
that communicates with a proxy-server that in turn communicates with the Intemet. A device that does not have the 

50 specialized browser, or cannot execute the specialized browser cannot retrieve or display content using the proxy- 
server. 

[1 328] Thus, the prior art teaches that it is necessary to develop an independent technique to provide access to 
particular information. For example, the prior art technique for mobile phones was not used on portable computers and 
conversely 

55 

Summary 

[1329] Therefore, It is desirable to provide a method and a system allowing the access of data, particulariy over a 
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network, to a variety of different user devices, including mobile phones and handheld computers. 

[1 330] A method for presenting data on a user device with presentation requirements relating to the presentation of 

this data on the user device, comprises the following steps: 

5 d) receiving a request from the user device for the data by data presentation management means, 

e) identifying the presentation requirements of the user device to the data presentation management means, 

f) selecting a presentation scheme for the data in accordance with the presentation requirements, so that the 
10 presentation scheme can be applied to the data to create presentable data to allow the presentation of the data 

on the user device. 

[1 331] Herein, the step c) may be earned out by the data presentation management means. The inventive method 
may also comprise the step d) of applying the presentation scheme to the data to create presentable data to allow the 
IS presentation of the data on the user device. This step d) may be carried out by the data presentation management 
means. However, step d) may also be earned out by the user device or by any other device which applies the presen- 
tation scheme and provides the presentable data to the user device. 

[1 332] The aforementioned method may be supplemented by the further step e) of transmitting the presentable data 
to the user device to allow the presentation of the data on the user device. 

20 [1 333] The data may be retrieved by the data presentation management means before the application of the selected 
presentation scheme to the data. In another embodiment of the present invention the data may be retrieved by the 
user device itself. Then, the selected presentation scheme may be applied by the user device or by the presentation 
management means. The latter would, for example, apply, if the data retrieved by the user device would be transfen-ed 
to the presentation management means for applying the selected presentation scheme and than be re-transferred to 

25 the user device. 

[1334] In the scope of the present invention a method is also provided for obtaining data by a user device having 
presentation requirements relating to the presentation of the data on the user device, comprising the following steps: 

c) submitting a request by the user device to data presentation management means for obtaining the data from 
30 the data presentation management means, the request causing the identification of the presentation requirements 

of the user device to the data presentation management means, the selection of a presentation scheme for the 
data in accordance with the presentation requirements of the user device by the data presentation management 
means, the request further causing the application of the selected presentation scheme to the data to create pre- 
sentable data, and 

35 

d) receiving in the user device the presentable data to allow the presentation of the data by the user device. 

[1335] Furthemiore, a method is provided for obtaining data by a user device having presentation requirements 
relating to the presentation of the data on the user device, comprising the following steps: 

40 

d) submitting a request by the user device to data presentation management means for obtaining the data from 
the data presentation management means, the request causing the identification of the presentation requirements 
of the user device to the data presentation management means and the selection of a presentation scheme for 
the data in accordance with the presentation requirements of the user device by the data presentation management 

45 means, 

e) receiving In the user device the selected presentation scheme for the data, 

f) applying in the user device the selected presentation scheme on the data to create presentable data. 

50 

[1 336] Herein, the user device may receive the data via data management presentation means, as described eariier. 
[1337] Data jn the scope of the present invention is the representation of information. This information can be pre- 
sented by any suitable means, for example, text, picture, sound, movie or action. Different kinds of information can 
also be combined. This data may be accessible to the user device, for example, via a network. For the retrieving of 
55 the data certain requirements of the user device have to be considered. Such requirements may be of different type. 
They include presentation requirements. They may further have different origin. For example, the requirements may 
be caused by the software on the user device, which may support only specific kinds of information. It may also be 
possible that the requirements depend of the hardware of the user device, if the user device can, for example, present 
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information merely via a loudspeaker. User depending requirements are also possible in the scope of the present 
invention. This may be caused by certain preferences of the user as well as by a handicap. 

[1 338] In the scope of the present invention data includes also functions. Such functions may t>e, for example, actions 
for presenting data, for example, movies and sound as well as function for processing on data like, for example, cal- 

5 . ojlation functions or spellchecker. 

[1 339] A user device according to the present invention may be, for example, a computer system comprising at least 
a processor, a storage medium and an i-/o-interface. Via this i-/o-interface the user device may be connected to the 
source of the data. It will also be possible that the requested data is stored on the storage medium of the user device. 
Regularly, the user device comprises also input and output devices connected via the i-/o-interface. 

10 [1 340] The requested data may be retrieved via at least one portJet. In the context of the present invention a portlet 
is understood to be means for providing the requested data from a data source, for example, from a certain homepage 
or data base. 

[1 341] Two or more portlets may be arranged in tree-like organization. This tree-like organization may be presented 
to a user of the user device, for example, on a screen of the user device, so that this user has the possibility to easily 
15 choose among the offered portlets. 

[1342] the presentation requirements of the user device may be determined based on information about the user 
device. For example, if the data presentation management means are informed about the type of the user device they 
may conclude therefrom the presentation requirements of the user device. 

[1343] In the context of the present invention data presentation management means are hardware or - generally - 

20 software means for managing the presentation of data on a user device. Their exact functionality depends on the 
implementation of the present invention. The functionality of the data presentation management means includes at 
least the selection of the presentation scheme for the requested data in accordance with the presentation requirements 
of the user device. For this purpose the data presentation management means must be informed about the presentation 
requirements of the user device. Furthermore, the functionalities of the data presentation management means may 

25 include the application of the selected presentation scheme on the requested data in order to create presentable data 
to be presented by the user device. This requires the availability of the requested data for the data presentation man- 
agement means. The retrieval of this data may also be carried out by the data presentation management means. 
[1344] The presentation schemes may be defined, for example, in an extensible stylesheet language (XSL). XSL is 
a language for creating a stylesheet which describes how content being fomnatted in an extensible markup language 

30 (XML) will be presented to a user device. The presentation scheme may describe, for example, if a certain content 
defined in XML will be displayed, where this content will be displayed and how it will be displayed. 
[1 345] The methods of the present invention may be implemented in a computer program (computer program prod- 
uct), including comprehensive office applications. A computer program product comprises a medium configured to 
store or tranisport computer readable code, or in which computer readable code may be embedded. Some examples 

35 of computer program products are: CD-ROM disks, ROM-cards, floppy disks, magnetic tapes, computer hard drives, 
servers on a networtc and carrier waves and digital signals transmitted over a telecommunication link or network con- 
nection. 

[1346] Such a computer program may be stored on any common data carrier like, for example, a floppy disk or a 
compact disk (CD), as well as on any common computer system's storage facilities, like hard disks. 
40 [1 347] Therefore, the present invention also relates to a data carrier for storing a computer program for carrying out 
the inventive methods. The present invention also relates to a method for using a standard computer system for carrying 
out the present inventive methods. 

[1 348] In the scope of the present invention a computer system is provided comprising at least a processor, a memory 
and an i-/o-interface for representing data depending on presentation requirements of a user device relating to the 
45 presentation of the data on the user device, comprising data presentation management means, wherein the data pres- 
entation management means include: 

f) at least one receiving module for receiving a request of the user device for the data, 

50 g) at least one identifying module for identifying the presentation requirements of the user device, and 

h) at least one selecting module for selecting a presentation scheme for the data in accordance with the presentation 
requirements. 

55 [1 349] Furthermore, the computer system may comprise 

i) at least one retrieving module for retrieving the data, and 
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j) at least one applying module for applying the selected presentation scheme to the data to create presentable 
data which may be presented by the user device. 

[1 350] The retrieving and the applying functions may also be carried out in a user device or in a computer system 
5 being accessible to the user device. Therefore, the retrieving module and the applying module may also be located in 
the user device or in any computer system which is connectable or connected to the user device and which is able to 
deliver the result of the application of the presentation scheme, the presentable data, to the user device. 
[1 351 ] The aforementioned computer system may be supplemented by a transmitting module e) for transmitting the 
presentable data to the user device to allow the presentation of the requested data on the user device. 
10 [1 352] According to an embodiment of the present invention, a method and a system allow access to data, particulariy 
over a network, to a variety of different user devices. Including mobile phones and handheld computers. Unlike the 
prior art methods, this method and system are not limited to devices that have either a predefined configuration, or 
predefined software loaded on the device. Rather, the presentation requirements of a device are determined, and a 
document compatible with those presentation requirements is generated by a presentation manager server system. 
15 [1 353] Consequently, the problems associated with updating and providing specialized software to each type of user 
device have been eliminated. Also, it is no longer necessary to write specialized software for each type of user device 
that is provided data from a single content source, or for each content source that has a different data format. 
[1 354] In one embodiment, a method for presenting data on a user device comprises: 

20 receiving, by a presentation manager, a request from the user device for data from any one of a plurality of different 

data sources, 

identifying presentation requirements of the user device to presentation manager, and 

25 selecting a presentation scheme for the data in accordance with the presentation requirements of the user device, 

where the presentation scheme can be applied to the data to generate presentable data for the user device, 

[1355] In one embodiment, this method also includes applying the presentation scheme to the data to create the 
presentable data. This operation is performed by the presentation manager, by the user device, or by any other device, 
30 which applies the presentation scheme and provides the presentable data to the user device. The aforementioned 
method may be supplemented by transmitting the presentable data to the user device to allow the presentation of the 
data on the user device. 

[1 356] In another embodiment of the present invention, a method also is provided for obtaining data by a user device 
having presentation requirements relating to the presentation of the data on the user device. This method includes 

35 submitting a request to obtain data by the user device to a presentation manager coupled to the user device. The 
request causes the identification of the presentation requirements of the user device to the presentation manager, and 
the selection of a presentation scheme for the data in accordance with the presentation requirements of the user device 
by the presentation manager. The request further causes the application of the selected presentation scheme to the 
data to create presentable data. This method further includes receiving in the user device the presentable data to allow 

40 the presentation of the data by the user device. 

[1 357] In one embodiment of the present device, the data requested is retrieved via at least one portlet coupled to 
the presentation manager. Herein, a portlet is understood to be means for providing the requested data from a data 
source, for example, from a certain homepage or database to the presentation manager 

[1358] Two or more portlets may be arranged in tree-like organization. This tree-like organization is presented to a 
45 user of the user device, for example, on a display screen of the user device, so that this user has the possibility to 
easily choose among the content offered via the portlets. 

[1 359] In one embodiment, the presentation requirements of the user device are determined based on information 
about the user device. For example, if the presentation manager is informed about the type of the user device, the 
presentation manager can determine therefrom the presentation requirements of the user device and select a pres- 
50 entation scheme based thereon. 

[1 360] Presentation schemes may be defined, for example, in an extensible style sheet language (XSL). The pres- 
entation scheme may describe, for example, if a certain content defined in XML is displayed, where this content is 
displayed and how this content is displayed. 

[1 361 ] In another embodiment of the method of this invention, a request is received from a user device. The request 
55 was generated in response to a selection of a portlet identification object on the user device. The request is transferred 
to a portlet. The portlet retrieves data specified in the request over a network. This data has one format in a plurality 
of source data formats. 

[1 362] The request also is analyzed to determine a user data format that is supported by the user device. A presen- 
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tation scheme to convert the data from the source data format to the user data format is then selected. The retrieved 
data is converted from the source data format to the user data format using the presentation scheme. 
[1363] In one embodiment of selecting a presentation scheme includes selecting an XSL-stylesheet. The received 
request includes, in another embodiment, a command. The command is selected from a group of commands consisting 
5 of load, save, article, and channel. 

[1 364] In yet another embodiment of the present invention, a web sender receives a request from a user device. The 
request was generated by selection of a portlet identification object on the user device. The web server analyzes the 
request to determine whether the request is for content associated with a portlet. The request is transfen^ed to a pres- 
entation manager upon the web server determining that the request Is for content associated with a portlet. The pres- 
to entation manager passes the request to a portlet. The portlet retrieves data specified in the request over a network. 
The retrieved data has a source MIME type. 

[1365] The presentation manager analyzes the command to Identify a user MIME type, and then selects a presen- 
tation scheme from a plurality of presentation schemes based upon the user MIME type and the source MIME type. 
The presentation manager converts the data from the source MIME type to the user MIME type using the presentation 
15 scheme. 

[1366] Thus, in one embodiment of the present invention, a presentation manager server system includes a web 
sender, a presentation manager coupled to the web server, and at least one portJet coupled to the presentation manager. 
The at least one portlet may comprise any one of a mail portlet. a resource description framework portlet, and an 
internal networic information portlet. A portlet is associated with content that is retrieved by that portlet The presentation 
20 manager server system also may include a storage medium having stored thereon a plurality of presentation schemes. 
[1 367] In one embodiment of the presentation manager server system the web server comprises a servlet container, 
and the presentation manager comprises a servlet. 

[1 368] A computer program product, according to one embodiment of the present invention has stored thereon com- 
puter instructions for a method comprising: 

25 

receiving a request from the user device for the data; 

identifying presentation requirements of the user device; and 

30 selecting a presentation scheme for the data in accordance with the presentation requirements wherein upon 

application of the presentation scheme to the data, new data presentable on the user device Is generated. 

[1 369] A computer program product, according to another embodiment of the present invention has stored thereon 
computer Instructions for a method comprising: 

35 

receiving a request from a user device generated by selection of a portlet identiffcation object on the user device; 

transferring the request to a portlet wherein the portlet retrieves data specified in the request over a networi< and 
further wherein the data has one format in a plurality of source data formats; 

40 

analyzing the request to determine a user data fomnat that is supported by the user device; 

selecting a presentation scheme to convert the data from the source data format to the user data fomiat; and 

45 converting the data from the source data format to the user data format using the presentation scheme. 

[1 370] A computer program product, according to yet another embodiment of the present invention has stored thereon 
computer instructions for a method comprising: 

50 receiving a request from a user device generated by selection of a portlet identification object on the user device 

by a web server; 

analyzing the request by the web server to determine whether the request is for content associated with a portlet; 

55 transferring the request to a presentation manager upon determining that the request is for the content associated 

with a portlet; 

passing the request to the portlet by the presentation manager wherein the portlet retrieves data specified in the 
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request over a network and further wherein the data has a source MIME type; 

analyzing the request to identify a user MIME type; 

5 selecting a presentation scheme from a plurality of presentation schemes based upon the user MIME type and 

the source MIME type; and 

converting the data from the source MIME type to the user MIME type using the presentation scheme. 

10 Brief description of figures of CHAPTER D 

[1 371] The present invention will now be described in detail on the basis of examples, where reference will be made 
to the appended figures, which show: 

IS Fig. 1 A illustrates one embodiment of a networt( including a plurality of user devices coupled to a pres- 

entation manager server system according to one embodiment of the present invention. 

Fig. 1B is a more detailed illustration of one embodiment of user device 102A of Figure 1A including 

portlet icons according to one embodiment of the present invention. 

20 

Fig. 2A is a process flow diagram according to one embodiment of the present invention. 

Fig. 28 is a process flow diagram for selecting portlets that can be accessed by a user device according 

to one embodiment of the present invention. 

Fig. 3 is a more detailed illustration of the presentation management server system according to one 

embodiment of the present invention. 

Fig. 4 is a more detailed process flow diagram of the retrieve scheme operation of Figure 2A. 

Fig. 5 is sequence diagram for the portlet manager according to one embodiment of the present in- 

vention. 

Fig. 6 is an example of a class PortletManager that is used to instantiate the portlet manager object 

35 according to one embodiment of the present invention. 

Fig. 7A and 78 are an example of method do Post and do Get according to one embodiment of the present 
invention. 

40 Fig. 8A and 88 are an example of a class CommandFactory that includes method producecommand according 
to one embodiment of the present invention. 

Fig. 9A to 9E are an example of a class LoadCommand according to one embodiment of the present invention. 

45 Fig. lOAand 108 areanexampleof a class SaveCommand according to one embodiment of the present invention. 

Fig. 11A to 11J are one emt>odiment of class ChannelCommand according to one embodiment of the present 
invention. 

50 Fig. 12 is a block diagram of modules in the portlet manager according to one embodiment of the present 

invention. 

Fig. 13 is a schematic representation of an example for the method and system of the present invention, 

55 Fig. 14 is schematic representation of the screen print of a user device using the present invention, 

Fig.1 5 is a flow chart showing obtaining the presentation requirements of a user device. 



25 
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Fig. 1 6 is a flow chart showing the steps to be carried out by a method according to the present invention, 

and 

Fig. 17 is flow chart showing the operation of a method of the present invention. 

[1372] In the Figures 1 - 17 of CHAPTER D and the following Detailed Description of CHAPTER D. elements with 
the same reference numeral are the same element or a similar element. Also, the first one or two digits of a reference 
numeral for an element indicate the figure in which that element first appeared. Reference numerals do not necessarily 
correspond to the reference numerals used in the further chapters. 

Detailed description 

[1 373] According to the principles of this invention, a single presentation manager 1 1 3. executing on a presentation 
manager server system 100, accesses infomiation from any one of plurality of content sources 101A to 101C in re- 
15 sponse to a request from any one of a plurality of user devices 102A to 102R Each of the plurality of user devices 
1 02A to 1 02F may have different requirements for presentation of infomiation retrieved by presentation manager 1 1 3, 
i.e., different presentation requirements. When a request for information is received from a particular user device, 
presentation manager 113 retrieves the information, identifies the presentation requirements of the particular user 
device, and then transforms the information, if necessary, using a presentation scheme specific to the user device so 
20 that the information can be presented on the particular user device. 

[1374] The presentation requirements may be any conditions or limitations on the presentation of data on the user 
device, for example, kind and size of display on the user device, type of programming language or data fonmat supported 
by the user device, or any other presentation requirements of the user device, for example, of the processor or the 
memory. These presentation requirements not only may result from technical necessities, but also may result from an 
25 individual user's demands or wishes. The user is not constrained to accessing data in a format that is compatible with 
the one particular device that the user happens to be using as in the prior art. 

[1375] Hence, presentation manager server system 100 solves the prior art information access limitations by giving 
users access from whatever device is available at the time, through a single system entry point, to a complete com- 
plement of data. As explained more completely below, presentation manager server system 100 frees a user from time 

30 and location constraints when accessing the complete complement of data. 

[1376] A user can access data on Internet 106 and/or enterprise network 103 from almost any available device, e. 
g., any one of a portable computer 102A. a mobile telephone 102B, a workstation 102C, a home personal computer 
(PC) 102D, a personal digital assistant 102E, or an Internet cafe machine 102F. No longer is a user limited to using a 
particular device with pre-installed software to access a particular type of data accessible via a network to which the 

35 device is coupled. 

[1377] For example, a user taps an icon displayed on PDA 102E to generate a request for a sales report that is 
stored in a database on legacy system 101C. The request is sent over Internet 106 to presentation manager 113 that, 
in tuni, retrieves the sales report via an internal portlet 117, ti"ansforms the sales report according to a presentation 
scheme for PDA 1 02E, and transmits the ti^nsformed sales report to be displayed on PDA 1 02E. A similar transaction 

40 could be done using Internet caf6 machine 102F, or periiaps mobile telephone 102D. 

(1 378] Each user device in the plurality of user devices 1 02A to 1 02F accesses infonnation through the same portlet. 
However, in a first embodiment, presentation manager 113 retrieves the information using the portlet and then ti-ans- 
forms the information using a presentation scheme tiiat is specific to the user device so that the retiieved information 
can be displayed by the user device. Alternatively presentation manager 113 could provide the presentation scheme 

45 and the retrieved data to the user device and the transformation of the retrieved data could be done on the user device 
itself. 

[1379] Plurality of devices 102A to 102F is illustrative only and is not intended to limit the invention to the particular 
devices illustrated. The devices could also include, for example, a POTS telephone, a pager, a set-top box connected 
to a television, a networic appliance, or any other device that is connectable to a network and can issue a request for 
so data, as described more completely below, arid display the data received in response to the request. This embodiment 
of the present invention is not limited to a particular type of user device or to a particular group of user devices as in 
the prior art, or to user devices that are running a particular software program. 

[1380] The user can access multiple content sources via presentation manager server system 100. Different types 
and formats of data from different applications can all be accessed and processed within a single user interface. Further, 
55 data from extemal sources, such as stock quotes, weather forecasts, or periiaps news tickers from wet>-based service 
providers can t>e accessed using the same single user interface. According to the principles of this invention, presen- 
tation manager server system 100 is a comprehensive client/server offering tiiat enables users, from almost any device 
anywhere, to access and view different types of data from a wide variety of content sources. 
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[1381] As an example, consider user device 102A (Figs. 1A and IB) that is a portable computer. The display on 
display screen 150 includes, within a work area, three porttet icons, e.g., an Internal page icon 120, an extemal page 
Icon 121, and a news ticker Icon 122. In this example, the use of Icons to represent portlets is illustrative only and Is 
not intended to limit the invention to this specific embodiment For example, a list of text names could also be used. 

5 In general, a portlet Identifier is provided to a user, and upon selection of the portlet identifier by the user, a request is 
sent to presentation management server system 1 00 to retrieve and return content associated with the portlet Identifier. 
[1 382] In an explorer region on display screen 150 Is a mail icon 121 . If the user selects mail icon 121 , a hierarchical 
view Is generated on display screen 1 50A as illustrated in Figure 1 6. each entry of which represents a portlet that can 
be used, In one embodiment, to request Information from presentation manager server system 100. Corresponding to 

10 each Icon displayed on user device 102A Is a porttet, e.g., portlets 1 1 5 to 1 1 7 that are coupled to presentation manager 
113. as explained more completely below. 

[1383] Alternatively, Icons 120 to 122 on display screen 150 could each expand into a hierarchy of Icons. Moreover, 
upon selection of an icon, typically by the user placing a cursor on the icon and clicking a mouse, the user could be 
presented, for example, with an Input screen in which the user input commands for acting on data. When the user 
15 completes the input screen, a request that includes the commands for acting on data is dispatched to presentation 
manager server system 100. 

[1384] Thus, according to the principles of this Invention, a portlet icon, or more generally, a portlet identifier, is not 
limited to issuing only a request to retrieve information. The user-initiated request can also include commands that 
perform operations on data, for example. However, In each case, a portlet icon is associated with a specific source of 

20 information, sometimes called content, as explained more completely below. 

[1 385] Instead of the screen portlet Icons in Fig. 1 B. the portlets may also be offered to the user in the form of a text 
based listing on the display of the user device. This listing may be put together in presentation manager 113, for 
example, in the extensible Markup Language (XML)fomnat. In addition, the user can obtain a list of information sources 
available through presentation manager server system 100 by issuing a request to presentation manager 113 that Is 

25 not addressed to a specific portlet. With this list, the user can select portlets of interest to the user, as explained more 
completely below with respect to Fig. 2B. 

[1 388] Thus, an individual user can personalize the user device by specifying which service providers from among 
the ones the organization has made available via portlets, the user wants to use. To put it another way, the user chooses 
which portlets the users wishes to fc>e included on the desktop as illustrated In Fig. IB. (A portlet Is the smallest unit of 

30 information that can be put In a portal.) Hence, presentation manager server system 1 00 eliminates prior art limitations 
on a single user system on a network accessing content on any desired provider system that is coupled to the network. 
(1 387] When a user selects one of the icons on display screen 1 50, user device 1 02A, which is coupled to a networic 
server 111 by an enterprise network 103, issues a request associated with the selected icon. The request specifies (i) 
a suitable address to the location where the content associated with the request Is stored, for example, the Internet 

35 address of a homepage In the form of a uniform resource locator (URL), and (11) infomiation conceming either the types 
of data that can be processed and displayed by user device 1 02A. e.g., MIME types, and/or, an identifier that Indicates 
the processing and display capabilities of user device 102A. In addition, the request can Include operations that are 
to be performed on the data, or using the data, e.g., find ail web sites including the word or words specified in the request. 
[1388] Enterprise network 103 is illustrative only of one embodiment of a network. The particular type of networic 

40 connecting a user device to presentation manager server system 1 00 is not essential, and may be the Internet or any 
other permanent or temporary networic, for example a local area networtc. 

[1389] Upon receipt of the request, networic server 111 in presentation manager server system 100. which in one 
embodiment is a web server, detemnines that the request Is for data accessed via presentation manager 113 and 
transfers the request to presentation manager 113. 

45 [1 390] Upon receipt of the request from network server 111, presentation manager 11 3, as explained more completely 
below, passes the request to the portlet associated with the request. For example. If the user issued a request for ail 
new mail niessages. presentation manager 113 would pass the request to mail portlet 115 that is associated with mail 
system 101 A. If the request was for information on an extemal network, presentation manager 113 passes the request 
to extemal portlet 116 that may be associated, for example, with one of web sites 101 B. In one embodiment, portlet 

50 116 accesses web sites 101B that provide content using the Resource Description Framewori^ (RDF). 

[1 391 ] The portlet that receives the request from presentation manager 113 retrieves the requested data and returns 
the data to presentation manager 113. Typically, each of the plurality of portlets 1 1 5 to 11 7 accesses data, i.e.. content, 
in a different fomnat. Of course, one or more portlets could be configured to retrieve data having the same format. For 
example, text based information may be provided In the HTML format as well as In the WML format. 

55 [1 392] In addition to passing the request to the appropriate portlet. presentation manager 113 identifies the presen- 
tation requirements of the user device for the requested data. Using the identification of the presentation requirements, 
presentation manager 113 selects a presentation scheme for the requesting user device. 

[1393] As used herein, the presentation scheme for a user device is the totality of the configuration information 
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needed to extract data from a first format and transform the data into new data for presentation on that user device. 
In one embodiment, as explained more completely below, the presentation schemes include a plurality of extensible 
Style sheet Language (XSL)-stylesheets that Is stored on a storage medium for access by presentation manager 113. 
Each XSL-stylesheet transforms extensible Markup Language (XML) data to new data that can be processed and 

5 displayed by a particular user device, sometimes referred to as user device presentable data. 

[1394] In selecting a presentation scheme, in one embodiment, presentation manager 113 determines whether the 
request from the user device includes a specific identification of a presentation scheme; a list of MIME types that the 
user device is capable of displaying; and either a user identification and/or a device identification. If the user request 
specifies a specific presentation scheme, for example, a particular XSL-stylesheet, presentation manager 113 selects 

10 that stylesheet as the presentation scheme. If a MIME type is specified in the request and presentation manger 113 
has an XSL-stylesheet for transforming the requested content to that MIME type, this XSL-style sheet is selected. If 
the requested content is in a MIME type that Is in the list of MIME types in the request, presentation manager 113 
simply passes the retrieved content straight thru. If presentation manager 113 cannot identify a specific presentation 
scheme for the requested data, presentation manager 113 simply passes the retrieved content straight thm, in one 

15 embodiment. Thus, in each instance, presentation manager 113 identified the presentation requirements based upon 
information specified in the request, and selected an appropriate presentation scheme. 

[1 395] The presentation scheme selected by presentation manager 1 1 3 is retrieved and loaded into a local memory. 
When the requested data is available in a memory addressable by presentation manager 113, presentation manager 
113 uses the stored presentation scheme to process the stored data and thereby generate user device presentable 
20 data, which may be presented in accordance with the requirements of user device 102A that transmitted the original 
request. Finally, the user device presentable data is transferred to user device 102 A over the network coupling user 
device 102A to presentation manager server system 100. 

[1396]^ Hence, through use of a dynamic content channel, e.g., a portlet, a highly customizable content page may 
be produced for any individual client system. Moreover, a particular user device is not limited to accessing content in 
25 a format identical to that associated with the user interface in use on the user device. Consequently, the user's ability 
to access a wide variety of content sources independent of the characteristics of the particular user device is further 
enhanced with the portlets in this embodiment of the invention. 

[1397] As used herein, a user device and/or a computer system includes at least a processor, a storage medium, 
and an l/O-ihterface. In the context of the present invention, data refers to any type of information, which is arranged 
30 in certain order to be accessible by a computer system. The data to be accessed may also include one or more functions 
or functionalities provided to the user of a user device. Functions are, in this context, possibilities given to the user to 
initiate actions beyond the mere retrieval or display of information, for example, a search on the Internet for a certain 
publication or the initialization of a software program on a remote server canying out some operations in response to 
the user device's request. 

35 [1398] Figure 2A is a process flow diagram of one embodiment of a method 200 the present invention. Figure 3 is 
a more detailed block-level diagram of one embodiment of presentation manager server system 100 that implements 
method 200 of Figure 2A. In this embodiment, network server 111 is a web server 111, and presentation manager 113 
is a portlet manager 113. 

[1 399] As explained above, a user initiates a request on a user device by selecting a portlet identifier, e.g., an icon, 

40 for example, that represents a particular instance of data that is accessible via a particular portlet in presentation 
manager server system 1 00. In this embodiment, an icon representing a portlet is only selectable for display on display 
screen 150 (Fig. IB) if the data provided by the portlet may be presented by the user device. For example, if the user 
device does not support graphics, a portlet, which provides data with the MIME type image/jpeg, would not be available 
for selection for display on display screen 1 50 of device 102A. 

45 [1400] In one embodiment, ttiis pre-selection of portlets offered to the user is made by a comparison of the MIME 
types supported by the user device and the Ml ME type of data for each of the portlets. Fig. 2B is a process flow diagram 
of a method 280 that is used in one embodiment of the present invention to preselect portlets that are made available 
to a particular user device. Mettiod 280 is not started unless a user issues a request to select one or more portlets for 
a particular device. This is represented by preselect portlet for access request check operation 281 that typically is 

50 part of a graphic user interface event handler, or part of a windowing system event handier 

[1 401] Upon ttie user issuing a request to preselect one or more portiets, check operation 281 designates the portlet 
selected, or one of the portlets selected, as the current portlet and transfers processing to get user Ml ME types operation 
282. In operation 282, presentation manager server system 100, in ttiis embodiment, obtains the MIME types supported 
by ttie user device, i.e., obtains the user MIME types, and transfers to get source MIME types operation 283. 

55 [14021 operation 283, the source MIME types supported by the cun-ent portlet are retiieved and processing ti-ans- 
fers to common MIME type check operation 284. If at least one of the user MIME types and one of tine source MIME 
types are the same MIME type, processing ti-ansfers to portlet available operation 287, and otherwise to generate 
MIME type set operation 285. 
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[1403] In generate MIME type set operation 285, presentation schemes 303 are used to generate another set of 
MIME types, which are the MIME types produced when presentations schemes 303 are applied to the source MIME 
types. Operation 285 transfers processing to common MIME type check operation 286. 

[1404] If at least one of the user MIME types and one of the MIME types in the set of MIME types generated by 
5 Operation 285 are the same MIME type, processing transfers to portlet available operation 287, and otherwise to portlet 
unavailable operation 288. 

[1 405] In portlet available operation 287, the current portlet is flagged as available to the user device and an appro- 
priate response is supplied to the user device. For example, the portlet icon could t>e installed on the user's desktop. 
[1406] In portlet unavailable operation 288, the current portlet is flagged as unavailable. In this case, a message is 

10 sent to the user that access to the portlet is not available firom this user device. 

[1407] Both operations 287 and 288 transfer to additional portlets check operation 289. If the user requested to 
preselect more the one portlet, the next portlet in the user request is identified as the current portlet, and operations 
283 to 288 are repeated, as appropriate. If the user only requested to preselect one portlet, or all of the portlets have 
been processed, check operation 289 passes to the end operation that cleans up and exits. 

15 [1408] In the above example relating to graphics, the presentation capabilities of the user device did not support 
graphics. The comparison with the MIME type .of data defined by the various portlets shows that a portlet defining 
image/jpeg as its MIME type of data cannot be supported by this user device. Accordingly, the user device via method 
280 would be denied access to this particular portlet. 

[1 409] Method 280 may be made at any suitable location, for example, in the user device as well as in web server 
20 111, in portlet manager 113. or in the respective portlet itself. Consequently, in the following description, when user 
device submits a request in operation 210. no subsequent checking is done to assure that the requested data can be 
displayed on the user device. However, in another embodiment, the user is allowed to send requests to all available 
portlets. and as each request is sent, if the request cannot be processed for whatever reason, an error message is 
returned to the user device. 

25 [1410] The request transmitted in send request operation 210 (Fig. 2A) includes at least a description of the requested 
data. Such a description may be. for example, the URL of the data. The request typically also includes the MIME type 
or types supported by the user device, e.g., wireless application protocol (WAP) for mobile phone 102B. The request 
may also include either or both of the identity of the user device and the identity of tiie user of the user device. As 
explained more completely below, the request may further include a command, such as channel, load, save, or article. 

30 [1411] The request from the user device in operation 210 goes over a network to server 111, which in this embodiment 
is a web server 111. In one embodiment, web server 111 is ttie Tomcat server supplied by The Apache Software 
Foundation, 1901 Munsey Drive, Forest Hill, MD 21050-2747, U.S.A. However, in this embodiment, any HTTP server 
that supports the functionality and operations described herein can be used as web server 111. In one embodiment, 
web server 111 is a servlet container, and portlet manager 113 is implemented as a sennet. 

35 [1 412] In portiet check operation 215, web server 111 analyzes the request from the user device, sometimes referred 
to as the original request, to determine whether this request has to be processed by portiet manager 113. The altemative 
is to process the request directly by web server 111. 

[1413] Check operation 215 can be implemented in various alternative ways. In one embodiment, deployment de- 
scriptors as defined in tiie JAVA 2 Enterprise Edition are used and checked in operation 215 to determine where to 

<o direct the user request. The JAVA 2 Platform Enterprise Edition Specification. v1.2, Sun Microsystems, Inc., Palo Alto, 
CA (1999) and the JAVA Servlet Specification , v2.2. Sun Microsystems, Inc. Palo Alto, CA (1999) are incorporated 
herein by reference to show the level of skill in the art. Based upon the deployment descriptors, if the request is for 
web server 111, processing transfers to continue operation 217 and conventional processing continues. Otherwise, 
the request is forwarded to portlet manager 113 and processing transifers to contact portiet operation 220. 

45 [1 414] In another embodiment, the decision in check operation 215 is based on the MIME type of the requested data, 
i.e.. the MIME type of ttie data located at the URL in ttie request, and the MIME type supported by tiie user device. If 
the MIME type of tiie requested data and ttie MIME type supported by the user device are identical or at least compatible, 
the request is processed by web server 111. This condition is frequentiy fulfilled, for example, if a browser, which is 
able to handle and to process data in XML. requests a homepage, which is also formatted in XML. 

50 [1415] Thus, if the request is supported by web sender, 111, processing transfers to continue operation 216 and 
conventional processing continues. Othenwise. the request is forwarded to portiet manager 113 and processing trans- 
fers to contact portlet operation 220, 

[1 41 6] Portlet manager 113 may be implemented in software within web server 1 1 1 , or may be installed on a separate 
computer system, which is connected or connectable to web server 111. In one emk)odiment, portlet manager 113 is 
55 implemented as a servlet that executes on web server 111 . 

[1417] Typically, portlet manager 113 is not continually executing on web server 111, and so if a request is forwarded 
to portlet manager 1 1 3 in contact portlet operation 220, portiet manager 1 1 3 is started and ttien the request is f onwarded 
to portlet manager 113 for processing. 
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[1 41 8] Portlet manager 1 1 3 forwards the request to the appropriate portlet. The forwarding of the request to a specific 
portlet completes contact portlet operation 220. The portlet retrieves the data In retrieve data operation 230, and 
processing in portlet manager 113 transfers to MIME check operation 240 within identify user type operation 245. In 
Figure 2A, the operations are shown as sequential for ease of Illustration only. This Is not intended to limit the invention 
to this specific sequence of operations. The specific sequence will depend upon the computer system used and the 
specific implementation of this embodiment. 

[1 41 9] The request from the user device contains Information about the presentation requirements of the requesting 
user device, or contains information about the Identity of the user device, or contains both. If the request contains one 
or more MIME types processing transfers to get MIME type 241 and otherwise to identity check operation 242. 
[1420] In get MIME type from request operation 242, portlet manager 113 extracts a list of MIME types supported 
by the user device from the request including a preferred MIME type, if a preferred MIME type is specified. Operation 
241 transfers to Identity check operation 242. 

[1421] In Identity check operation 242, portlet manager 113 detemiines whether the request included identification 
Information. If Identity infomiation is Included processing transfers to get identity from request operation 243 and oth- 
erwise to retrieve scheme operation 270. Get identity from request operation 243 retrieves the device identification 
from the request and transfers to retrieve scheme operation 270. 

[1422] Operations 242 and 243 both transfer to retrieve scheme operation 270. In retrieve scheme operation 270, 
portlet manager 113 uses the information extracted from the request to retrieve a presentation scheme for the user 
device from a plurality of presentation schemes 303 stored on storage unit 302. In one embodiment, the retrieved 
presentation scheme Is loaded in a memory accessible by portlet manager 113. Retrieve scheme operation 270 trans- 
fers processing to convert data operation 271 . 

[1 423] Figure 4 is a more detailed process flow diagram of one embodiment of retrieve scheme operation 270. XML 
check operation 401 determines if the response content type Is other than an XMLfomiat supported by portlet manager 
113. If the response content type Is other than an XML format, processing transfers to copy response operation 402 
and othenwise to MIME type check operation 403. Check operation 401 and copy response operation 402 are optional. 
[1 424] In this embodiment, only transfomiations that utilize an XSL-stylesheet are supported, and so If the response 
content Is not In a supported XML fomriat, the response content cannot be transformed. Accordingly, copy response 
operation 402 copies the response Information directly to web server 111 that can in turn send the copied response 
back to the user device for display Of course if other transformations were supported, e.g. , a JAVA class that extracted 
data from certain MIME types and Inserted the data into an HTML template that could be returned to the user device, 
the applicability of each of the other transformations would be tested before defaulting of copy response operation 402. 
[1425] If XML check operation 401 detemnines that the response content type is a supported XML fomiat, a path to 
the appropriate XSL-style sheet in a plurality of XSL-style sheets 303 stored on storage unit 302 is constructed. MIME 
type check operation 403 determines whether the request from the user device included a prefen-ed MIME type. If a 
pretend MIME type was obtajned in operation 241 , processing transfers to device check operation 405, and othenwise 
to set 'Ml ME type operation 404. Set MIME type operation 404 uses the session identification to retrieve a preferred 
MIME type from user device configuration infomnation stored on storage unit 301. Operation 404 transfers to device 
check operation 405. Thus, upon entry to operation 405 a MIME type is specified. 

[1426] Device type check operation 405 determines whether the request from the user device included a device 
type. If a device type was obtained in operation 243, processing transfers to XSL check operation 407. and othenvlse 
to set device type operation 406. Set device type operation 406 uses the session identification to retrieve a device type 
from user device configuration information stored on storage unit 301 . Operation 406 transfers to XSL check operation 
407. Thus, upon entry to operation 407, a MIME type and a device type are. specified. 

[1427] XSL Check operation 407 determines whether the request from the user device specified a spedfic XSL- 
stylesheet. If a specific XSL-stylesheet was specified, processing transfers to XSL extension check operation 413 and 
othenvise to channel command check operation 408. 

[1428] In this embodiment, two commands, channel and article, result in retrieving data. Accorciingly. channel com- 
mand check operation 408 determines whether the command in the request was a channel command, and if it was, 
transfers to set channel XSL operation 411, and othenwise transfers to article command check operation 409. Set 
channel XSL operation 411 sets the XSL-stylesheet to a default channel XSL-stylesheet and transfers to prefen-ed 
XSL-stylesheet available check operation 415. 

[1429] When processing transfers to article command check operation 409. article command check operation 409 
determines whether the command in the request was an artcle command, and If It was, transfers to set article XSL 
operation 412, and othenwise transfers to exception operation 410. Set article XSL operation 412 sets the XSL-style- 
sheet to a default article XSL-stylesheet and transfers to preferred XSL-stylesheet available check operation 415. 
[1430] In this embodiment, exception operation 410 throws an exception and terminates the processing of portlet 
manager 1 13 for this portlet, because the requested information cannot be transformed for display on the user device. 
However, in another embodiment, portlet manager 1 1 3 may go to the website of a manufacturer of the user device, as 
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identified in the request, or to another appropriate website to download an XSL-stylesheet for the user device. Alter- 
natively, poiHet manager 1 1 3 may send a query to the user device asking whether the user device has such a stylesheet 
that can be downloaded. 

[1 431 ] If the request specified an XSL-stylesheet, check operation 40 1 transfen^ to XSL extension check operation 
413, which in tum determines whether the specification In the request included an XSL extension (.xsl). If the request 
included the extension, processing transfers to preferred XSL-stylesheet available check operation 415 and othenwise 
to set extension operation 414. Set extension operation 414 adds a XSL extension to the requested stylesheet and 
transfers to preferred XSL-stylesheet available check operation 415. Upon entry to operation 415, a MIME type, a 
device type and a XSl_-stylesheet are specified to that the path to the storage location of the stylesheet can be con- 
structed. 

[1 432] Preferred XSL-stylesheet available check operation 415 opens a folder on storage device 302 for the specified 
MIME type and then within the specified MIME type folder opens a subfolder for the specified device type. In the 
specified device type subfolder, operation 415 looks for the specified XSL-stylesheet. If the specified XSL-stylesheet 
is found, operation 415 transfers to parse and load operation 418, and otherwise transfers to XSL to MIME XSL- 
stylesheet available check operation 416. Thus, if operation 415 is successful, a device specific XSL-stylesheet has 
been retrieved. 

[1 433] I n Ml ME XSL-stylesheet available check operation 4 1 6, the specified XSL-stylesheet Is looked for In the spec- 
ified MIME type folder, and if the stylesheet is found, processing transfers to parse and load operation 41 8 and otherwise 
to exception operation 417. Exception operation 417 also terminates the processing because the XSL-stylesheet is 
unavailable. Again, in another embodiment, attempts to find a suitable XSL-stylesheet stored at another location could 
be made prior to throwing the exception. Load and parse operation 418 loads and parses the retrieved stylesheet into 
a memory for further use by portiet manager 113 and transfers to operation 271 (Fig. 2A). 

[1434] When the portiet completes the retrieval of the requested data In retrieve data operation 230. convert data 
operation 271 is initiated. When convert data operation 271 receives both the data and the presentation scheme, portiet 
manager 113 processes the retrieved data using the stored presentation scheme to generate new data that can be 
displayed on the user device. For example, if the retrieved information is a XML docurnent, the XSL-stylesheet loaded 
in memory Is used to do the transformation. If the retrieved information is e-mail data, a JAVA class is used to extract 
the data and insert the data for example into a HTML template. 

[1 435] Convert data operation 271 transfers to return converted data operation 272. In operation 272, portiet manager 
113 returns the converted data in a HTTP response to web server 111. Web server 111 sends the HTTP response to 
the user device that sent the original request. 

[1436] In display data operation 273, the user device processes the HTTP response, and displays the response to 
the original request on the user device. 

[1 437] In this example, it was assumed that convert data operation 27 1 was performed on the same computer running 
portiet manager 113. However, in another embodiment, retrieve scheme operation 270 and retrieve data operation 230 
send the retrieved scheme and retrieved data respectively to another computer system connected to the user device, 
or the user device itself. In these cases, convert data operation 271 is performed on the another computer system, or 
the user device, and returned converted data operation 272 is performed only if operation 271 was executed on other 
than the user device. 

[1 438] In the above embodiment, it was assumed that portiet manager 113 was able to identify the type of presentation 
requirements for the requesting user device and retrieve a presentation scheme that converted the type of the requested 
data to a type that could be displayed on the user device. In another embodiment, a presentation scheme is not available 
to convert the retrieved data to a type of data that can be displayed on the user device. For example, the user requests 
a spreadsheet that is a data format specified by the manufacturer of the application that generated the spreadsheet. 
The presentation scheme available for the user device requires an input document in XML. Since the retrieved docu- 
ment in not in XML, the presentation scheme is not useful. 

[1439] However. In this situation, portiet manager 113 issues a translation request to a filter server 315. In one em- 
bodiment, portiet manager 113 sends a request that includes the MIME type required as input to the presentation 
scheme for the user device, and an address of the requested document to filter server 315. This address can be to a 
memory where the document Is stored after being reti-ieved by a portiet, or a URL to location of the document on the 
networic. The only requirement is that filter server 31 5 is able to access the requested document. 
[1440] In response to the request filter server 315 builds a filter that can read the requested document, dynamically 
convert the read data using a partial filter adapter chain to the new format, and then write the converted data in the 
new format so that the data can be supplied to presentation manager 113. More specifically, in response to the request 
from presentation manager 113, filter server 315 via a conversion service 310. in one embodiment, causes a protocol 
reader to be instantiated and uses the protocol reader to access the requested document to determine the format of 
the requested data. I.e.. the source document data format. With the source document data format and the target doc- 
ument data format, i.e., the MIME type received in the original request, filter server 315 builds a filter for converting 
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the format of source document to the format of the target document 

[1441] In the embodiment of Figure 3, filter server 315 passes the request to a conversion service 310 that in tum 
accesses a filter registry 311 to generate a filter map of partial filter adapters that can be chained together to convert 
the fomriat of the requested document to the MIME type specified In the request Using the filter map, conversion service 
310 calls a service to instantiate each partial filter adapter in the map using partial filter adapter library 312. Conversion 
service 310 calls another service to chain the partial filter adapters together using a chaining application programming 
interface of each partial filter adapter. 

[1 442J In this embodiment, filter server 31 5 via conversion service 310 constructs a data filter by gluing a protocol 
read and parser unit to an input end of the partial fitter adapter chain and a bit stream printer and protocol writer to an 
output end of the chain. After construction of the data filter, conversion service 310 uses the data filter to process the 
requested. document, e.g., the spreadsheet The data filter generates data with a MIME type that can be input to the 
presentation scheme that is returned to presentation manager 113, which in tum processes the data as described 
above. 

[1443] One important aspect of filter server 315 is that each partial filter adapter utilizes the same generic fomriat 
independent interface to input the converted data. This allows any one partial filter adapter to be connected to another 
partial filter adapter without concern for the particular format of the data output by the first partial filter adapter 
[1 444] In one embodiment, the data filter is used dynamically, which means that the complete data file is not stored 
in the intermediate formats. Rather, the output from a first partial filter adapter Is input to a second partial filter adapter 
before all the data has been processed by the first partial filter adapter 

[1 445] A more complete description of filter server 315. and each of the components therein is provided in CHAPTER 
E. In another embodiment, filter server 315 provides information about the dynamic filter to portlet manager 113, and 
portlet manager 113 stores a new presentation scheme on unit 302 that includes the dynamic filter generated by filter 
server 315, or at least a handle to the dynamic filter, and the retrieved presentation scheme. 
[1 446] While in Figure 3 filter server 315 is illustrated as being included within presentation manager server system 
100, this is illustrative only. Filter server 315 can be in another computer system, part of a portal, or even on the user 
device. Portlet manager 113 is coupled to filter server 315 to send and receive the information described above. 
[1 447] In one embodiment, the URL in the request from the user device is of the fomi: 

http: //<server>:<port>/portlet/<command 
sting> ?<parameters> 



[1448] In this embodiment, the command strings are: load; channel; article; and save. Command load loads infor- 
mation about the requested data. With command save, the user device submits settings made by the user that are to 
be saved along with the user data. To provide the content of a portlet to a user device, command channel is submitted. 
Command article is submitted to retrieve an article of a portlet. 

[1449] Figure 5 is sequence diagram for one embodiment of portlet manager 113. Along the horizontal axis are 
individual objects, where each object is represented as a labeled rectangle. The vertical axis represents the passage 
of time from top to bottom of the page. Horizontal lines represent the passing of messages between objects. A dashed 
line extends down from each rectangle, and a rectangle along the dashed line represents the lifetime of the object. 
[1 450] When web server 1 1 1 receives a URL that specifies a portlet, web server 1 1 1 searches for the servlet that is 
portlet manager 113. If portlet manager 113 has not been loaded, web server 111 first creates a configuration object 
specific to portlet manager 113, and then calls a portlet manager initialization method with the configuration object as 
an input 

[1 451 ] After portlet manager 1 1 3 is initialized, portlet manager 11 3 first issues a get context message to the config- 
uration object and then issues a get parameters object message to the configuration object In the embodiment of 
Figure 6, the configuration path names are loaded to XSL and XML files. The creation and initialization messages are 
issued by web server 111 only once for the purpose of initialization. Subsequently, the search for the servlet that is 
portlet manager 113 finds manager 113. 

[1452] In this embodiment, HTTP Post and Get requests that are included in the request from the user device are 
passed to portlet manager 1 1 3 from web server 1 1 1 each time either request arrives at web server 1 1 1 for a portlet for 
which portlet manager 113 was configured initially. Specifically, when a user requests includes a HTTP Get request 
web server 1 1 1 creates a HTTP request object for portlet manager 1 1 3, and a HTTP response object for portlet manager 
113 as illustrated in Figure 5. Web server 111 next calls a method do Get, with the HTTP request object and the HTTP 
response object as inputs, in portlet manager 113. 

In response to the call to method do Get. portlet manager 113 issued calls to methods get header and get servlet path 
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of the HTTP request object. Portlet manager 113 builds a string that specifies the URL of the portlet based on the 
information in the request from the user device. See Figures 7A to 7B for one emboidiment of HTTP Get and Post 
commands and method do Get. 

[1453] Once the URL is built, portlet manager 113 instantiates a new command factory using a dass CommandFac- 
5 tory, and then calls a method produce command in the command factory with the HTTP request object as an Input. 
Method produce command extracts the command string from the URL as given above and instantiates a channel 
command object when the command string is either channel or article; a load command object when the command 
string is load; and a save command object when the command string is save. The method produce command returns 
the command object. 

10 [1 454] One embodiment of class Command Factory that includes method producecommand is presented in Figures 
8A to 8B. One embodiment of class LoadCommand Is presented In Figures 9A to 9E. An embodiment of class Save- 
Command is presented in Figures 1 0A to 1 0B. 

[1 455] In the following discussion, it is assumed that the request issued by the user device included command article 
or command channel and so the channel command object was created. In this case, portlet manager 113 in method 

15 do Get calls method execute in the channel command object with inputs of the HTTP request object, the HTTP response 
object and the URL. Figures 11 A to 11J are one embodiment of class ChannelCommand that includes method execute. 
[1456] tn method execute, the URL that is input is checked to determine whether a portlet is specified. If the URL 
does not specify a portlet, an URL container is accessed and information about all available portlets is obtained from 
the URL container If a portlet is specified, the part of the URL that specifies the portlet is used to build a URL object 

20 that in turn is used to make a connection to retrieve the requested content, 

[1 457] After the URL object is created, all fields in the HTTP request object are copied to the new request that actually 
is sent to retrieve the requested content. These fields can include, for example, the name of the browser in the user 
device. The MIME types in the original request as well as the MIME types supported by portlet manager 113 are included 
in the new request. Upon completion of the new request, method execute uses the URL object to make a connection 

25 and to retrieve the requested content 

[1 458] If the connection uses the HTTP protocol, infomiation in the HTTP header can be used to recognize the MIME 
type of the response content. IF the protocol is not HTTP, the extension of the URL is check to determine the type of 
the response content If the extension of the URL is .xmt, a guess is made of what type of XML file is requested by 
analyzing a field DOCTYPE in the headier of the XML file. In the case that a XML file based on a certain document 

30 type definition Is recognized, the response type is set to the name associated with the document type definition. If the 
response is not an XML file, the URL connection object guesses the content type of the response content. This is done 
by a JAVA URLConnnection object that is part of the JAVA mntime environment, which is incorporated herein by ref- 
erence to show the level of skill in the art. 

[1 459] In this embodiment, if the response content type is other than an XML format supported by portlet manager 
35 113, the retrieved content without any modification is returned as the response to the request from the user device. In 

the embodiment of Figure 2B, this does not occur, because the user device would not have access to such a portlet. 

[1460] If the request was a HTTP request, and no preferred MIME type was specified, the prefen-ed MIME type 

associated with the user is used. If the request failed to specify a device type, the device type associated with the user 

is used. If the request was for a XML file, and the XML parameter that specified the stylesheet in the original request 
40 . was not used, a channel XSL-stylesheet is used if the command in the original request was command channel, an 

article XSL style sheet is used if the command in the original command was command article. If the original request 

specified an XSL-stylesheet, this stylesheet is used. (See Fig. 4.) 

[1461] A path to the appropriate XSL-stylesheet is built by method execute using the specified MIME type, device 
type and XSL-stylesheet If a user device specific XSL-stylesheet cannot be found at this location, a generic device 

45 independent stylesheet is used based upon the specified MIME type. In this embodiment, there is a XSL-stylesheet 
for mapping each source MIME type to each user device MIME type. Thus, for a portlet with two possible MIME types 
and a user device that supports two possible MIME types, four XSL-stylesheets are needed. 
[1462] With the specification of the XSL-stylesheet and the XML content, ail the objects needed for the XSL trans- 
formation are set. The received content is parsed as an XML document and the whole document is held as a Document 

50 Object Model tree in memory. The XSL-stylesheet is parsed and loaded into memory. 

[1463] If the loaded document is a lists of portlets because no portlet was specified in the original URL. or has a 
MIME type that is not accepted by the user device, the document is modified in a memory to which the user is not 
subscribed. This is necessary, because such content could not be displayed on the user device. 
[1464] If the loaded document is an article, it is checked whether this MIME type is accepted as a response by the 

55 user device- Next, the global parameters for the XSL transformation are set, and the loaded XML document is trans- 
fomned according to the rules in the XSL-stylesheet. The output of the transform is streamed to the HTTP response 
object. 

[1 465] Figure 1 2 shows an example of a portlet manager 1 1 3 according to the present invention as described above. 
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Portlet manager 113 comprises, in this example, six modules. Module A is a receiving module for receiving a request 
of the user device. Module B Is an identifying module for identifying the presentation requirements of the user device. 
These two modules are able to communicate with the selecting module C to enable module C to select a presentation 
scheme for the requested data in accordance with the presentation requirements of the user device. 

5 [1 486] In the present example, portlet manager 1 1 3 comprises also a retrieving module D for retrieving the requested 
data. Applying module E applies the presentation scheme selected by module C to the data to create presentable data, 
which may be presented by the user device. This presentable data is submitted by a transmitting module E to the user 
device. Modules D. E and F need not be part of portlet manager 113. Modules D, E and F or some of them may also 
reside on the user device or on a computer system connected to the user device. 

10 [1467] In view of this disclosure, various alternative embodiments will be apparent to those of skill in the art. For 
example, in the above embodiment, data was retrieved by presentation manager 113, and presentation manager 113 
applied the selected presentation scheme to the data. In another emtxxjiment of the present invention, the data may 
be retrieved by the user device itself. Then, the selected presentation scheme may be applied by the user device or 
by the presentation manager. The latter, for example, would apply if the data retrieved by the user device were trans- 

15 f erred to presientation manager 11 3 for applying the selected presentation scheme and then re-transferred to the user 
device. 

[1468] Those skilled In the art wilt readily understand that the operations and actions described herein represent 
actions performed by a CPU of a computer in accordance with computer instructions provided by a computer program. 
Therefore, presentation manager 1 1 3 and any associated portlets may be implemented by a computer program causing 
20 the CPU of the computer to carry out instructions representing the individual operations or actions as described above. 
The computer instructions can also be stored on a computer-readable medium, or they can be emt)odied in any com- 
puter-readable medium such as any communications link, like a transmission link to a LAN, a link to the Internet, or 
the like. 

[1 469] Thus, presentation manager 1 1 3, portlets, or any combination of the two. can be implemented by a computer 
25 program comprising computer program code or application code. This application code or computer program code 
may be embodied in any form of a computer program product. A computer program product comprises a medium 
configured to store or transport this computer-readable code, or in which this computer-readable code may be embed- 
ded. Some examples of computer program products are CD-ROM discs, ROM cards, floppy discs, magnetic tapes, 
computer hard drives, servers on a networi^, and earner waves. The computer program product may also comprise 
30 signals, which do not use carrier waves, such as digital signals transmitted over a network (including the Internet) 
without the use of a earner wave. 

[1470] The storage medium including the presentation manager and/or portlets executed on a server may belong to 
presentation manager server system 100 itself. 

However, the storage medium also may be removed from presentation manager server system 100. The only require- 
35 ment is that the program code for these objects is accessible by system 1 00 so that the computer code can be executed 
by system 100 in the embodiment of Figure 1 A. 

[1471] Herein, a computer memory refers to a volatile memory, a non-volatile memory, or a combination of the two 
in any one of these devices. Similariy, a computer input unit and a display unit refer to the features providing the required 
functionality to input the information described herein, and to display the information described herein, respectively. In 

40 any one of the aforementioned or equivalent devices. 

[1472] Fig. 13 shows another example of a system and method according to the present invention. A user device 
like a mobile phone la or a laptop computer 1b may want to access certain data via the network 2. This network 2 may 
be the Internet or any other permanent or temporary network, for example a local area networic. Other user devices 
are suitable as well in the scope of the present invention. Examples include any kind of computer systems, like servers 

45 and personal computers, and any devices which are able to process data and to communicate with other devices for 
exchanging data. In this context computer systems may include at least a processor, a storage medium and an i-/o- 
interface. In the . context of the present invention data refers to any type of information which is arranged in certain 
order to be accessible by a computer system. The data to be accessed may also include one or more functions or 
functionalities provided to the user of a user device. Functions are, in this context, possibilities given to the user device 

50 to initiate any actions beyond the mere retrieval or display of information, for example, a search in the internet for a 
certain publication or the initialization of a software program on a remote server carrying out some operations in re- 
sponse to the user device's request. 

[1 473] If the user device 1 a or 1 b wants to access certain data via the network 2. it will send a request for said data, 
for example, for a certain homepage, to a webserver 3. The webserver 3 comprises a processor, a memory and an i-/ 
55 o-interface. In particular, the webserver 3 includes means for receiving this request. The request may specify the data 
requested from. the mobile phone la or the laptop lb by giving suitable address data as to where this data can be 
found, for example, the Internet address of a homepage (URL). 

[1474] This request will be forwarded to data presentation management means, in the following exemplary referred 
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to as poiHet manager 4. This portlet manager 4 may be implemented in software within the webserver 3 or may be 
installed on a separate computer system which is connected or connectable to the webserver 3, Having received the 
request for data from the webserver 3 the portlet manager 4 identifies the presentation requirements of the user device 
having sent the request for the data with respect to the presentation of the data to this user device. For this purpose 

5 the user device has means for Identifying these requirements. These presentation requirements may be any conditions 
or limitations for the presentation of data on the user device, for example, kind and size of display for data on the user 
device, type of programming language or data fomnat supported by the user device, or any other presentation require- 
ments of the user device, for example, of the processor or the memory. These presentation requirements may not only 
result from technical necessities, but also from an individual user's demands or wishes. The presentation requirements 

10 of the specific user device are identified by the respective means either by being provided the information about the 
presentation requirements directly from the user device, together with the request for the data or separately, or by 
being provided information about the type of the user device and by procuring the needed information alwut the pres- 
entation requirements of the so identified user device from a data base, which may or may not be an integral part of 
the portlet manager, and which connects information about the type of the user device with the desired information 

15 about the specific presentation requirements of the user device with respect to the presentation of the requested data. 
[1475] In order for the data to comply with the identified requirements the portlet manager 4 loads all configuration 
information needed for presenting the requested data to the user device 1a or 1 b, respectively. Configuration information 
is all information about the layout and the presentation of the requested data. It must con-espond to the identified 
requirements. The totality of the configuration information needed to present data to a certain user device is refen-ed 

20 to as a presentation scheme. This is selected according to the presentation requirements of a certain user device by 
the data presentation management means, i.e. the portlet manager 4. For this purpose, XSL-stylesheets, which may 
be stored in storage medium 5 may be selected according to the identified requirements by means 7 for presenting 
data in accordance with the identified presentation requirements of the user device la. These means 7 are generally 
implemented in software. They may, for example, have access to a further external storage medium 8 on which, for 

25 example, XSL-stylesheets may be stored. The configuration data loaded in response to the user device's request may 
be stored in a specific file until the data to which it shall be applied has been provided. 

[1476] The portlet manager 4 now retrieves the requested data. The data is procured via the webserver 3 fi-om 
portlets 9, 10, ... . Portlets 9, 10, ... represent ways for accessing the requested data. This data may have different 
formal For example, text based information may be provided in the HTML format as well as in the WML fomnat. The 

30 portlets 9, 10, ... have means for accessing data, including software modules, to retrieve the requested data for the 
portlet manager 4 from any accessible location, including internet homepages, data bases and other storage media. 
[1 477] In the portlet manager 4 the means 7 will then apply the presentation scheme loaded from storage media 5, 
6 and 8 tothe data. This presentation scheme will be applied to the data. Herewith, the data which was requested by 
the user device la or lb, respectively, is converted to presentable data which may be presented in accordance with 

35 the requirements of the user device la or lb, respectively. 

[1478] Finally, the data may be transferred to the user device 1a, lb which requested it in the presentation required 
by this user device la, 1b. Herewith, the user device la, lb may access the requested data in proper form. 
[1479] Fig, 2 gives an example of a user's view on the present invention by showing a print-out of a screen 20 of a 
user device, here a laptop, utilizing a method according to the present invention. Screen 20 shows symbols 21, 22, 

40 23 each standing for one portlet - 9, 10, ... in Fig. 13. The symbols 21, 22, 23, ... offered on the screen 20 and the 

portlets associated therewith can be freely chosen by a user of the user device. 

[1 480] However, a portlet is only selected for display on screen 20, that means the user can only choose it, if its data 
may be presented by the user device. For example, if the user device does not support graphics, a portlet which defines 
the MIME type image/jpeg will not be selected for display on the screen 20, that means it will not be offered to the user 

45 of the user device. This pre-selection of portlets to be offered to the user is made by a comparison of the requirements 
of the user device and of the MIME type of data defined by each of the portlets. In the above example relating to 
graphics the presentation requirements of the user device, the laptop, regarding the presentation of data will not allow 
to support graphics. The comparison with the MIME type of data defined by the various portlets will show that a portlet 
defining image/jpeg as its MIME type of data cannot be supported by this user device. Therefore, it will not be displayed 

50 on the screen 20. This comparison may be made at any suitable location, for example, in the user device as well as 
in the webserver, in the portlet manager or in the respective portlet itself. 

[1481] Instead of the screen print-out given in Fig. 14 the portlets may also be offered to the user of the user device 
in the form of a text based listing. This listing may be put together In the portlet manager, for example, in the XML 
fomnat. The information required for this listing, namely which portlet defines which mime type of data, may be retrieved 
55 via the webserver from the various portlets. 

[1482] Fig. 15 shows in a flow chart one possible way to fulfill the presentation requirements of the user device la 
or lb, respectively. In a first step 31 the user device la, lb sends a request to the portlet manager 4 via the webserver 
3. This request either contains information about the presentation requirements of the requesting user device la, lb 
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or it contains information about the identity of the user device 1a, 1b. it further includes a description of the requested 
data. Such a description may be. for example, the URL of the data, if the requested data can be found on a homepage 
on the Internet. The portlet manager 4 will contact in step 32 the con-esponding portlet for retrieving this data. If the 
requested data is only available from several different portlets, those would be contacted in this step. In a next step 
33 the portlet manager 4 retrieves the data from the one or more portlets. In order to consider the presentation require- 
ments of the user device 1 the portlet manager 4 needs information about these requirements. In one embodiment of 
the present invention the portlet manager 4 extracts from the request in a further step 34 a list of MIME types supported 
by the user device la, lb. In another embodiment the portlet manager 4 may have a list of the presentation requirements 
of different user devices 1a, lb. In this case, the portlet manager 4 may analyze the identity of the user device la, 1 b 
in step 35 and then contact this list in step 36 in order to obtain the infomriation about the requirements of the user 
device la, lb. 

[1483] Fig. 16 shows a flow chart representing a method according to the present invention for presenting data on 
a user device with certain data presentation requirements. In a first step 41 the data presentation management means, 
i.e. the portlet manager 4 receives a request for data from a user device 1 a, 1 b. In the next step 42 the portlet manager 
4 identifies from this request the presentation requirements of the user device la, 1b, as it was above described in 
relation to Fig. 1 5. In step 43 a presentation scheme is selected for the requested data in accordance with the identified 
presentation requirements. This enables the user device la, lb or the portlet manager 4 or another computer system 
which is able to be connected to the user device la, lb or to the portlet manager 4 to apply the selected presentation 
scheme to the data delivered by the portlets in order to anive at presentable data which may t>e presented to the user 
device la, lb. 

[1484] Fig. 17 presents an exemplary embodiment of the method of the present invention. In this example, a setup 
as presented in and described in connection with Fig. 13 is used. Therefore, reference numerals below 50 refer to 
devices shown in Fig. 13. 

[1 485] In step 50 the user device, for example, a mobile phone la sends a request for data via the network 2 to the 
websen^er 3. The mobile phone la uses the wireless application protocol (WAP) as MIME type for data which it handles 
and processes. A browser may run on the mobile phone la. The requested data may be, in this example, a certain 
homepage which is available on the Intemet at a certain URU. This homepage is programmed, for the purposes of this 
example, in an extensible maricup language (XML). The request of the mobile phone la includes at least the URL of 
the requested homepage and the MIME type supported by the mobile phone la, i.e. WAP. In this example, the identity 
of the user device 1 a. 1 b and its user is transmitted together with or as a part of the request. The request also includes 
a command, for example, "channel", if the content of the requested URL shall be loaded onto the user device. 
(1 486] In step 51 this request of the mobile phone 1 a is analyzed by the webserver 3 in order to decide whether this 
request has to be processed by the portlet manager 4. The alternative is to provide the data directly by the webserver 

3. This decision - made in step 52 - is based on the MIME type used for the requested homepage and the MIME type 
supported by the mobile phone la. 

[1 487] If the above question would be answered with "NO", then the requested data will be directly provided by the 
webserver 3 to the mobile phone la in step 53. This would require that the MIME type of the requested data and the 
MIME type supported by the mobile phone 1a are identical or at least compatible. This condition will frequently be 
fulfilled, for example, if a browser - which is able to. handle and process data in XML - requests a homepage - which 
is also formated in XML. 

[1488] If the answer to the above question is "YES", the request is fonwarded by the webserver 3 to the portlet 
manager 4 in step 54. The portlet manager 4 may be a servlet. A servlet is an extension to a webserver which provides 
the webserver with infonmation and logic. If a request for a certain URL, for example, is fonwarded to the portlet manager 

4, the portlet manager 4 is started. This leads to the portlet manager 4 processing the request. This processing includes 
doPost requests as well as doGet requests as it is shown in Table 1 . In order to simplify the further communication the 
portlet manager 4 employs the URL mentioned in the request forwarded by the webserver 3 for identifying itself and 
saves this address in a string. The portlet manager 4 identifies also the requested command. In one embodiment of 
the present invention there are supported at least the following commands. The "load" command loads infomiation 
about the requested data. With the "save" command the user device submits settings made by the user device 1a in 
order to save these settings along with the user data. In order to provide the content of a portlet to a user device the 
"channel" command is submitted.. Since the user device la requests in this example data from a portlet the "channel" 
command will be submitted. by the mobile phone 1a. The functionality of the portlet manager 4. especially certain 
commands, is described in detail in the code shown in Table 1 . 

[1489] In step 55 the identity of the user device la and of the user employing the user device la is retrieved from 
the request. Then, in step 56, the portlet manager 4 will access an internal or extemal storage medium, for example, 
data base 8 in order to check whether for the identified user device la and for the identified user a presentation scheme 
or parts of a presentation scheme are already stored. For example, a certain user may request a specific character 
type (font) for the data to be presented on the display of his mobile phone la, or a certain mobile phone la may request 
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a specific character size (font size) in view of its specific display. 

[1490] If "NO**, that means the storage medium does not have any infomiation about a presentation scheme or a 
part of a presentation scheme assigned to the specific user or the specific requesting user device la, the portlet man- 
ager 4 may search in step 57 in the network 2 for such individual presentation schemes or parts thereof. 
[1 491 ] For exaniple, if the network 2 is the Intemet the porttet manager 4 may contact the homepage of the producer 
or distributor of the mobile phone 1a In order to find the desired infomiation there. If the search of the porttet manager 
4 is successful, the presentation scheme or part of a presentation scheme will be retrieved in step 58. If the search is 
not successful, a default presentation scheme will be provided for later application to the requested data in step 59. 
[1492] If "YES", that means the storage medium has information about a presentation scheme or a part of a pres- 
entation scheme assigned to the specific user or the specific requesting user device 1a, the portlet manager 4 loads 
this presentation scheme or part thereof in step 60. 

[1493] In step 61 , based on the presentation scheme or part thereof retrieved and based on the request of the user 
device 1a the portlet manager 4 requests from one or more porttets 9, 10, ... the delivery of the requested data, here 
the homepage with the URL specified in the request of the user device la. This request includes a list of all MIME 
types which are either supported by the user device 1a or which may be converted by the portlet manager 4 into a 
MIME type which is supported by the user device la. Other additional information like, for example, the type of the 
browser used by the user device la may also be included in the request to the portlet In step 61 the portlet manager 
4 asks the portlets 9, 1 0 ... whether they are able to deliver the requested data in a MIME type listed in the request. In 
order to submit the request it may be necessary to create a connection to the portlet. 

[1494] If "NO", that means if the data cannot be delivered by the portlets 9, 10, ... ina MIME type which is supported 
by the user device la or which can be converted by the portlet manager 4 into a MIME type supported by the user 
device 1a. an error message is created in step 62. which is sent to the mobile phone la in order to report that the 
request for^data sent in step 50 to the webserver 3 cannot be fulfilled. 

[1495] If "YES", that means if the data can be delivered by the portlets 9, 10, ... in a MIME type which is supported 
by the user device la or which can be converted by the portlet manager 4 into a MIME type supported by the user 
device la, the data are received by the portet manager 4 in step 63. In step 64 the MIME type of the received data is 
analyzed as to whether the user device la supports it or conversion by the portlet manager 4 is necessary. 
[1496] If no conversion is necessary, the requested data are transfen^ed to the user device la directly via the wet>- 
server 3 and the network 2 in step 65. If, however, conversion is required, what will be the case in our example where 
the homepage is in XML and the mobile phone la supports only WAP, the retrieved data will be analyzed in step 66 
as to whether it is present in an extended maricup language (XML). 

[1 497] If "NO", that means if the requested data is not in XML. the data will be converted in step 67 into the requested 
Ml ME type to arrive at presentable data by applying the corresponding presentation scheme, which includes conversion 
modules for the conversion of data between the respective MIME types. If. for example, the requested data would be 
supplied in HTML, this data would be converted from HTML to WAP in step 67. Subsequently, the created presentable 
data is sent to the user device la in step 65. 

[1498] If "YES", that means the data is in XML - like in the here chosen example - the portlet manager 4 will select 
the suitable presentation scheme. For XML data this presentation scheme may include a XSL stylesheet. If a user 
device specific presentation scheme is accessible, the portlet manager 4 will choose this. 

[1499] The requested data will then be subjected in step 68 to the application of the presentation scheme, in this 
example, to the selected XSL stylesheet. The presentation scheme may be retrieved by portlet manager 4 from storage 
medium 5. Herewith, the presentation scheme - here: the XSL stylesheet - is applied to the data so that presentable 
data Is created. This presentable data may t>e sent to the user device la in step 65. 

[1 500] Fig. 12 shows an example of a portlet manager 4 according to the present invention. The portlet manager 4 
comprises in this example six modules. Module A is a receiving module for receiving a request of the user device 1a, 
lb. Module s is an identifying module for identifying the presentation requirements of the user device la, lb. These 
two modules are able to communicate with the selecting module C in order to enable module C to select a presentation 
scheme for the requested data in accordance with the presentation requirements of the user device 1a, lb. 
[1 501 ] In the present example, the portlet manager 4 comprises also a retrieving module D for retrieving the requested 
data to the portlet manager 4. The applying module E will then apply the presentation scheme selected in module C 
to the data to create presentable data which may be presented by the user device. This presentable data will be 
submitted by a transmitting module E to the user device. The modules D. E and F need not be part of the portlet 
manager 4. They or some of them may also reside on the user device la, lb or on a computer system connected to 
the user device la, lb or to the portlet manager 4. 

[1 502] It will be understood that the present invention is not limited to the examples given and explained in detail. 
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Table 1: 

public class PortletManager extends HttpServlet 
t 

This method provides information about a servlet used as portlet manager to a user 
device. In this example the method returns the name of the servlet and a copyright notice. 

public String getServletlnfoO 
i 

return "Channel Manager - Copyright 2G00 Sun Microsystems, Inc."; 

} 

This method is called when the webserver (HTTP server) loads the servlet. It is only called 
once for the purpose of initialization. In this case configuration path names are loaded to 
the XSL and XML files. 

public void init (SezvletConfig configuration) 
throws ServletElxception 

•{ 

System. out. println(getServletInfo t ) ) ; 
super. init( configuration J; 

ni_aServletContext » configuration.getServletContext () ; 

m_aServletContext - getServletContext ( ) ; 

String sRootBase - null; 

String sXslBase « null; 

String sOserBase - null; 

String slioUserNazne « null; 

try 

( 

SRootBase « new string (getlnitParameter ("rootbase-uri") ) ; 

SXslBase « new String (getlnitParameter ( -xslbase-uri**) ) ; 

suserBase » new String (getlnitParameter ("userbase-uri") ) ; 
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sNoUserName - new String (getlnitParameter (*'nou3er-name") ) ; 

^ 

catch ( exception e ) 
( 

System. err. println ("some required init parameter is 

missing") ; 

throw new ServletException ("init parameter missing"); 

> 



) 

The doPost method is called every time a HTTP post request arrives at the webserver with 
a request for an URL for which the servlet was configured initially. Post requests are 
handled in the same method where get requests are handled, so the doGetQ method is 
called. 



public void doPost( HttpServletRequest request, 

HttpServletResponse response ) 
throws ServletException, lOException 

{ 

doGet (request, response); 

I 

The doGet method is called every time a HTTP get request arrives at the webserver with a 
request for an URL for which the servlet was configured, 

public void doGet ( HttpServletRequest aHttpServletRequest, 

HttpServletResponse aHttpServletResponse ) 
throws ServletException, lOException 

I 

try 
{ 

A string is formed which specifies the URL of the servlet based on the information coming 
with the request. This string can later be used to specify the servlet as target for a HTTP- 
request. This will be done once, because this URL can only change if the configuration of 
the webserver will change. In the latter case the servlet would be unloaded and loaded 
again. 

// do it only once 

if (m 3 PrefixPath. length ()«»«0) 

{ 

// build prefix path (e.g. 

www. sun . com: 8088/portal /CM/J 

String sKostName « 
String sContextPath « 
String sServletPath » •*"; 

// get host name part 

sHostName ° aHttpServletRequest .getHeader( "Host") ; 

if ((sHostName null) II ( sHost Name, length ( ) — 0) ) 
( 

SHostName » 

aHttpServletRequest .getServerName ( ) + 

":" + aHttpServletRequest .getServerPort () ; 
) 

SContextPath - getContextPath (aHttpServletRequest, 

new Object (0) ) ; 

sServletPath -« aHttpServletRequest . getServletPath I) ; 
// get servlet path part 

ra_sPrefiKPath « •*http://" + sHostName + sContextPath; 
nraDataFacade.setContextPath(m_sPre£lxPath) ; 
m_sPr€f ixPath +«• sServletPath; 
// concat 

m_aDataFacade.setPrefixPath(m_sPref ixPath) ; 
// set path on DataFacade " 

m_aCottmandFactory - new ComroandFactory () ; 
// new command factory 
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The actual work for resolving the request is done by separate objects. For each command 
specified in the URL given in the request a new object is instanced which is responsible to 
^ resolve the request. This approach is based on a design pattern called the „ Commands- 

pattern. In the current realization there are the commands „load*\ „save*', ^article" and 
„ channel". The object associated with each command is instanced by the class 
CommandFactory. 

// get command pattern and execute 
Command aCommand 

m aCommandFactory.produceCammandtaHttpServletRequeat) ; 

aCommand.eKecuteiaHttpServletRequest, aHt tpSer vie t Response, 
m_aDataFacade) ; 

) 

catch (Exception el 
15 ( 

e.printStackTrace (System. out) ; 

} 

> 



20 private ChannelHook m_aChannelHook - null; 

private CommandFactory m_a CommandFactory ■» null; 
private DataFacade ~ m^aDataFacade " null; 

private ServletContext m_aServletContext « null; 

private String m_sPref ixPath - 

) 

25 . The class CommandFactory parses the head of the specified 

URL for the request for a command, e.g. ^channel''. f 
known command is recognized the associated command object 
will be created- 

public class CommandFactory 
30 i 

public Command produceCommand(ServletRequest aRequest) 
throws ServletException 

( 

Command aCommand » null; 
String sOrl = null; 

35 Tlie following method makes sure that this is an HTTP request and gets the URL out of the 

request. 

if (aRequest instanceof HttpServletRequest) 
I 

HttpServletRequest sHttpServletRequest » 

(HttpServletRequest) aRequest; 
40 sUrl « SHttpServletRequest .getPathlnfoO ; 
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) 

else 
( 



throw new ServletException ( 

"Request is not of type HttpServletRequest" ); 



The follomng method tries to recognize the recent command by comparing the head of the 
URL with the known set of commands. If a known command is found the associated class 
is instanced and this instance is returned to the caller. 



// careful: sort order of if clauses is important 

if( sUrl !- null ) 

( 

if( sUrl.startsWith (CHANNEL) ) 
( 

aCommand = new ChannelCommandO ; 

) 

if( SUrl.startsWith (ARTICLE) ) 
( 
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aCommand - new ChannelCosmiandd ; 

) 

else lf( sUrl.start6Hith(LOA0» ) 
{ 

aConmand «* new LoadComniand ( ) ; 

) 

else i£( sUrl.startsWith(SAVE) ) 
( 

aCommand » new SaveCoiomand { ) ; 

System. out. prlntln<*'- new SaveConcnand*') ; 

J 

) 

it{ aCommand =° null ) 

throw new ServletException ( 

"Factory cant produce command for URL*' + sUrl 

) 

return aCommand; 



) 



public final static String LOAD - "/loader- 
public final static String CHANNEL = "/channel"; 
public final static String ARTICLE = "/article-; 
20 public final static String SAVE « "/save"; 



25 



The ChannelCommand has to provide the content of a portlet as a response to a request. 
The ChannelCommand is derived from the class Command, which is necessary, because of 
the use of the „ Command "-pattern. 
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public class ChannelCommand extends Command 
i 

public void execute ( ServletRequest 
Servlet Response 
Data Facade 
throws ServletException 

{ 

InputStream 
Input Source 
InputSource 
URLConnection 
String 
String 

aRequest . get Parameter < "href") . 
String 

aRequest .getParameter("Mime") i 
String 
String 
String 
String 
Hashtable 



aRequest, 

aResponse, 

aDataFacade) 



aOocInputStream 
aDocInputSource 
aTransInputSource 
aURLConnection 
sSessionid 
sEncodedORL 

sPreferredMimeType 



null; 
null; 
null; 
null; 

getSessionId (aRequest) i 



sDevice - aRequest . get Parameter ( "Device") ; 

sXSL « aRequest .getParameter("XSL") J 

sDecodedURL - ""; 

s Res pons eContent - ""; 

aXSLParameters = new Hashtable t); 
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try 
t 

(fno portlet is specificed in the URL information about all available pordets is returned. 
This will be decided by checking the URL for any additinal information. The information 
about all available portlets will be received from a data container called DataFacade. 
This concept is based on the design pattern Facade, 

//set URL for root channel list 
if ( (SEncodedORL— null) || 
(SEncodedORL. equals ("") ) I ( 
(sEncodedORL.equal5(*'root"} ) ) 



) 

else 
( 



SDecodedURL - aDataFacade.getRootBaseO j 
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sDecodedURL ORLDecoder .decode (a EncodedORL) ; 

The part in the URL which specifies the Portlets is an URL which can be used to retrieve 
the content of the Portlet. This will he used to build a corresponding URL object which 
will be used later on to build an URLconnection. 

//get URL connection 

URL aURL - new URL(sOecodedURL) ; 

aURLConnection -« aURL.openConncctiont } ; 

aURLConnection . setUseCaches ( false) ; 

aXSLParameters.putCPtoviderURL", aURL. toString ( ) ) ; 

In the following method all additional fields which are specified in the request will be 
copied to the new request. These fields can include, for example, the name of the browser 
used on the client side, that means in the user device. 
// tunnel properties 

java .util .Enumeration aHeaderNameList ** 
( (HttpServletRequest) 

aRcquest) . getHeader Names () ; 

while (aHeaderNameList .hasHoreEleraents 0 ) 

{ 

String sKey « (String) 

aHeaderNameList .nextElement () ; 

String dValue « ( (HttpServletRequest ) 

aRequest) .getHeader (sKey) ; 
aURLConnection. setReque3tProperty(sKey, svalue) ; 

) 

The additional MIME types which are supported by the portlet manager will be added to a 
list of accepted MIME types and this list will be added to the new request. 

// set own mime types, because some devices accept some 
// mime types which malce them crash... 
String sSupportedMimeTypes - 

aDataFacade.getSupportedMimeTypes (sSessionId) ; 

aURLConnection.setRe quest Property ("accept", 

SSupportedMimeTypes) ; 

The provider of the portlet content will be connected and the respective content will be 
read out by using an InputStream 

// get connection to URL 
aURLConnect ion. connect 0 ; 

InputStream aProviderResponse « 
aURLConnection. getlnputstream( ) ; 

In case of a HTTP connection the information in the HTTP header can be used to 
recognize the MIME type of the response. If the HTTP protocol is not used, the extension 
of the specified URLwill be checked. 

if { aURL.getProtocol t) .equals ("http") ) 
{ 

it get content type 

sResponseContent - aURLConnection.getContentType 0 ; 

) 

else 
( 

If it is recognized that a XML file is requested, it is tried to guess which kind of XML file it 
is by analyzing the DOCTYPE field in the header of the XML file. In the case that an XML 
file based on a certain DTD will be recognized the response type will be set to the 
associated name. 

// protocol is not http, so get content via file 
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if (sDecodedaRL.endsWithC.xml")) 
( 

//seems to be an xml file, so gee doctype 

content 

aProviderResponse.roark(10241 ; 
byteO aBuffer « new byte[10O01; 
aProvidecResponse . read (aBuff er) ; 
aProviderResponse . reset ( ) ; 

String aSearchString » new StringfaBuf fei) ; 

int nDoctypePosltion - aSearchString. indexOf ( 

"<! DOCTYPE *); 

if (nDoctypePosition— -1) 
{ 

//unknown Kml, send as binary 
5 Re spons eContent ■= 

} 

else 
{ 

// found "doctype", determine doctype 
String aTokenizerFeed - 

aSearchSt ring . substring (nDoctypePosition) ; 

StringTokenizer aTokenizer - new 

StringTokenizer (aTokenizerFeed, 

// get doctype 
aTokenizer . nextToken { ) ; 

String sResult • 

aTokeni zex . nextToken ( ) ; 

if (sResuIt .equals {** Channel s**} ) 
{ 

sResponseContent 

"text/vnd . sun. xml .Channels"; 

) 

else if ( sResult. equals ("Art icle**) ) 
{ 

sResporiseContent » 

"text/vnd . sun. xml .Article"; 

) 

else 
( 

//unknown xml, send as binary 
SResponseContent » 

) 

) 

) 

else 
{ 

If it is not a XML file, the class URLconnection will guess the content type of the response 
stream, 

//no xml file, so start guessing 
sResponseContent « 

aURLConnection . guessContentTypeFromSt ream{ 

aProviderResponse) ; 

if (sResponseContent*=null) 
{ 

//okay, now I'm helpless 
sResponseContent""" ; 

) 

} 

aXSLParameters.put ( "ProviderMiraeType", sResponseContent) ; 
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// xiol response? 

if ( ! sResponseContent . 3tartsHlth< "text/vnd.sun .xml . ") ) 
{ 

ff the response content is not in a XML format handled by theportlet manager, the 
response is returned as response to the original request without any modification. 

// upp3/ no xml, so simply tunnel thcough as raw data 
aResponse .setContentType (sResponseContent) ; 

if (aResponse inscanceof HttpServletResponse) 

^ 

{ (HttpServletResponse) 



aResponse) .setDateHeader ( 
System.currentTimeMilli3( ) ) , 



"Last-rModified" 

} 



The inputstream of the response is copied to the outputstream of the response of the 
original request. 

Inputstream aURLConnectionlnStreara = 

aProviderResponse; 

OutputStream aResponseOutStreain = 
aResponse . getOutputStream( ) ; 



bytell aBuffer = new byte (1024] ; 

int iReadLength ^ 0; 
int iReadLengthSum » 0; 

25 while t (iReadLength" 

(aURLConnectionlnStreara. read (aBuffer ) ) M — 1 ) 

{ 

aResponseOutStream. write (aBuffer , 0, IReadLength) ; 

iReadLengthSum += iReadLength; 



\ 

ff unfortunately available!) not possible, 

// so I have to use a buffer and set filelength at 



last 



aResponse. setContentLength (iReadLengthSum) ; 
2j aResponseOutStream. flushO ; 

return; 

) 

else 

I 

If no preferred MME type, device type or XSL-stylesheet specified with the request exists, 
40 the associated default type is used. 

ff yes, so build path for xsl file which generates 

response 

if ( (3PreferredMimeType'=null) I I 

(sPreferredMimeType.lengthO «»0) ) 

{ 

^5 // no mime parameter set so get it 

// via portal servlet 
sPreferredMimeType = 

aDataFacade .getPreferredMimeType (sSessionId) ; 

} 



if ( (sDevice«»=null) II {sDevice.length{)»=0) ) 
( 

// no device parameter set so get it 
// via portal servlet 
sDevice " 

aDataFacade. getDevlceName (sSessionId) ; 

} 
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If ( (3XSL«*null) II (sXSL.lengthO— 0) ) 

I 

If channels are processed, the channel sytlesheet is used, if articles are processed, the 
article stylesheet is used. 



sResponseContent. substring (17) ; 
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//no XSL parameter set so get via content 
String sSubMime - 

if (SSubMime .equals ("Channels' > ) 

sXSL - "Channels .xsl"; 

else if t sSubMime. equal s ( "Ar t icle* ) ) 

sXSL - "Article. xsl"; 

else 

throw new ServletException { 

••+++ no correct xsl type!!!"); 



) 

else 
{ 



If a XSL parameter is specified with the request, this stylesheet is used. 



// if no .xsl extension, add one 

if {sxSL.indexOf 1) 

( 

sXSL - sXSL+".xsl"; 

) 
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The path to find the XSL stylesheet file is built. First, a device specific file is searched for 
in a subdirectory with the name of the device. If this file is not available, the more generic 
device independent stylesheet is used. 

// build first chance path to xsl file 

URI. aTempURL » new URL(aDataFacade . getXSLBase ( } ) ; 

String sXSLBase « aTempURL. get File () / 

String sSubMime • sPr ef err edMimeType . substring ( 

sPreferredMimeType . indexOf <"/")+!) ; 

File aXSLMime ^ new File (sXSLBase, sSubMime); 
File aXSLDevice « new File (aXSLMime, sDevice); 
File aXSLFull - new File {aXSLDevice r sXSLI ; 

if (! aXSLFull. existsO J 



( 



transformation) 



''+aXSLrull -getAbsolutePath ( ) + 



// first chance xsl file not there build 
// second chance (no device specific 

aXSLFull - new File (aXSUlime, sXSL) ; 

if ( taXSLFull. exists (] ) 
I 

// no xsl found -> error 
throw new ServletException ( 
"+++ 

" file not found!"); 



All the objects needed to parse XML-documents and for the XSL transformation are set up, 

50 

// build parse environment 
ValidatingParser aValParser = 

new 

ValidatingParser (true) ; 

XmlDocument Builder aValDocBuilder 

55 
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Xml Document Builder ( ) ; 
ValidatingParser (false) ; 
XmlDocumentBuilder ( ) ; 
XSLTransfomEngine ( ) ; 



validatingParser 
XzalDocument Bui Ide r 
XSLTransformEngine 



Xml Document 
Xna Document 
Xml Document 



aParser 



aDocBuilder 
new 



aTr an s former = 
new 



aSourceDoc " null; 

aTrans former Doc null; 
aDrainDoc = 

new XmlDocument ( ) ; 



// hook own entity resolver for finding dtds 
XMLResolver aXMLResolver » new XMLResolver (true) ; 
aXMLResolver . registerCatalogEntries ( 



"com. sun. star. portal .channel .dtd**) ; 

// get /con fig parser and builder 
aValDocBuilder. set Parser (aValParser) ; 
aValParaer .set EInt it yResolver (aXMLResolver) ; 
aValDocBuilder . setDisableNamespaces ( f alse) ; 

aDocBuilder .setParser(aParser) ; 
aPdiser.setEntityResolver (aXMLResolver) ; 
aDocBuilder. setDisableNamespaces (false) ; 

Parse the received response as an XML document and hold the whole document as a 
DOM tree in memory. 

// parse received xml validating 

aDocInputSource = new InputSource (aProviderResponse) ; 
aDocInputSource .setSystemld(sDecodedURL) ; 
aval Parser . parse ( aDocInputSource ) ; 
aSourceDoc = aVal DocBuilder. get Document () ; 
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The XSL stylesheet is parsed and loaded into a memory. 

// parse xsl file NON validating 
aTempURL - aXSLFull.toURL( ) ; 
aXSLParameters . put ( "Trans f ormURL" , 

aTempURL . toStr ing 0 ) ; 

aTrans InputSource » new 
InputSource (aTempCJRL. toString{ } ) ; 

aParser. parse (aTransInputSource) ; 

aTrans formerDoc - aDocBuilder. getDocument () ; 

If the haded document is a list of channels, this document is modified in a memory to 
which a user is not subscribed or of which the MIME type is not accepted for the response. 
This is necessary, because such content could not be displayed on a user device. 
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if 

I sResponseContent . equals ( "text/vnd . sun. xml -Channels") ) 

{ 

Element aRootElement - 

aSourceDoc . getDocumentElement ( ) ; 

TreeWaDter aRootWalker = 

new TreeWallcer (aRootElement); 
Element aChannelElement « null; 

// valk through channel elements 
while ( (aChannelElement = 

aRootWalker .getNextEleraent ( "Channel" ) ) 

!«- null) 



// set subscribed attribute 
String sHref - 
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aChannelElement . getAttcibute ( *'href ** ) i 



sHref ) ) 



if (aDataracade .isSubscribecK 

sSessionZd, 



} 

else 
{ 



aChannelElement . set Attribute { 
"subscribed", "true"); 



aChannelElement . set Attribute { 
"subscribed", "false**); 
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TreeWaiker (aChannelElement) ; 



channel 



aMinieElement.getFir3tChild{ ) ; 
String (aNode.qetNodeValue ( ) ) ; 



TreeWaiker aChannelWaDter 
• new 

Element aMimeElenient - null; 
boolean bMimeAccepted = false; 

// walk through mime- type elements of 

while ( ( iaMimeElement - 

aChannelWalker . getKextElenent ( 
"mime-type") ) !« null) 
(! bMimeAccepted) ) 



{ 



Node aNode 



String sMimeType « new 



bMimeAccepted " 

aDataFacade . isMimeTypeAccepted ( 
sSessionId, sMimeType) ; 
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// set accepted attribute 
f (bMimeAccepted) 

aChannelElement. setAttribute ( 

"accepted", "true"); 



else 



aChannelElement . setAttribute ( 

"accepted", "false"); 
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) 

If the loaded document is an article, it is checked^ if this MIME type is accepted as a 
response. 

else 

if {sResponseContent. equals <"text/vnd. sun. xml. Article") ) 

{ 

Element aRootElement « 

a Source Doc. get Document Element () ; 

TreeWaiker aRootWalker = new 

TreeWaiker < aRootElement ) ; 
Element altemElement - null; 

// walk through item elements 
while ( (altemElement *= 

aRootWalker .getNextElement ( "Item") ) ! ■ 



null) 



TreeWaiker (altemElement) ; 



TreeWaiker altemwalker = new 



Element aMimeElement « null; 
k>oolean bMimeAccepted ■» false; 
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) 



aMimeElement . getFirstChild ( ) ; 
String(aNode.getNodeValue() ) ; 



sMimeType) ; 



-true") ; 



"false**) ; 



// walk through mime-type elements of 

while ( ( (aHimeElement » 

altemWalker.getNextElement ( 

"mime-type-)) != null) 
{ !bMime Accepted) 

( 

Kode aNode « 
String sMimeType - new 



bMime Accepted « 

aData Facade . i sMimeType Accepted ( 
sSessionid, 



// set accepted attribute 
if (bMimeAccepted) 
{ 

altemElement . setAttribute { 

-accepted", 

) 

else 
{ 

altemElement . setAttribute ( 

-accepted". 



} 



30 



35 



40 



45 



50 



The global parameters for the XSL transformation are set and the loaded XML document 
is transformed according to the rules in the loaded XSL stylesheet:' 



aXSLParameters] ; 



aTransformerDoc = aDataFacade.setParameters ( 
aTransformerDoc, aRequest, 



// transform 

aTransformer . createTrans form (aTransformerDoc) 



. trans form (aSourceDoc, aDrain[)oc) ; 



The outputstream for the response is obtained and the transformed XML document is 
streamed, which now can be, for example, HTML or WML to this stream. The webserver 
delivers this stream as the response of the original request to the client. 



aResponse . getOutputStream ( } ; 



// write it 

Outputstream aOutStream « 

aResponse . setContentType (sPref erredMimeJype) 
aDrainDoc. write (aOut St ream) ; 
aOutstream. flush ( ) ; 



) 

catch ( . . . 



) 



[1 503J In the following, further embodiments for representing data will be described. 
55 1 ) A method for presenting data on a user device comprising: 

receiving a request from said user device for said data; 
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identifying presentation requirements of said user device; and 

selecting a presentation scheme for said data in accordance with said presentation requirements wherein 
upon application of said presentation scheme to said data, new data presentable on said user device is gen- 
5 erated. 

2) The method of 1). further comprising applying said presentation scheme to said data to create said new pre- 
sentable data. 

10 3) The method of 2), wherein said applying said presentation scheme to said data is performed by said user device. 

4) The method of 2), further comprising: 

transmitting said new data to said user device to allow the presentation of said new data on said user device. 

15 5) The method of 1), further comprising retrieving said data. 

6) The method of 5), further comprising applying said presentation scheme to said retrieved data to create said 
new presentable data. 

20 7) The method of 1), wherein said request includes a command. 

8) The method of 7), wherein the command is selected from a group of commands consisting of load, save, article, 
arid channel. 

25 9) The method of 7), wherein the command is a command article. 

10) The method of 7), wherein the command is a command channel. 

11) A method for providing data to a user device comprising: 

30 

receiving a request from a user device generated by selection of a portlet identification object on the user 
device; 

transferring said request to a portlet wherein said portlet retrieves data specified in said request over a networl< 
35 and further wherein said data has one format in a plurality of source data formats; 

analyzing said request to determine a user data format that is supported by said user device; 

selecting a presentation scheme to convert said data from said source data format to said user data format; and 

40 

converting said data from said source data format to said user data format using said presentation scheme. 

12) The method of 11), wherein said selecting a presentation scheme comprises selecting an XSL-stylesheet. 
45 13) The method of 11), wherein said plurality of source data formats are MIME types, 

14) The method of 11), wherein said user data fomiat is specified by a MIME type. 

15) The method of 11), wherein said receiving is performed by a web server 

50 

16) The method of 11), wherein said transferring said request is performed by a portlet manager 

17) The method of 11), wherein said request includes a command. 

55 18) The method of 17), wherein the command is selected from a group of commands consisting of load, save, 

article, and channel. 

1 9) The method of 1 7), wherein the command is a command article. 
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20) The method of 17), wherein the command is a command channel. 

21) A method for providing data to a user device comprising: 

5 receiving a request from a user device generated by selection of a portlet Identification object on the user 

device by a web server; 

analyzing said request by said web server to determine whether said request is for content associated with a 
porttet; 

10 

transferring said request to a presentation manager upon determining that said request is for said content 
associated with a portlet; 

passirig said request to said portlet by said presentation manager wherein said portlet retrieves data specified 
15 in said request over a network and further wherein said data has a source MIME type; 

analyzing said request to identify a user MIME type; 

selecting a presentation scheme from a plurality of presentation schemes based upon said user MIME type 
20 and said source MIME type; and 

converting said data from said source MIME type to said user MIME type using said presentation scheme, 

22) The method of 21), wherein said selecting a presentation scheme comprises selecting an XSL-stylesheet. 

25 . 

23) The method of 21), wherein said request includes a command. 

24) The method of 23), wherein the command is selected from a group of commands consisting of load, save, 
article, and channel. 

30 

25) The method of 21), wherein the command Is a command article. 

26) The method of 21) wherein the command is a command channel. 
35 27) A presentation manager server system comprising: 

a web server; 

a presentation manager coupled to said web server; 

40 

at least one portlet coupled to said presentation manager 

28) The presentation manager server system of 27), wherein said at least one portlet comprises a mail portlet. 

45 29) The presentation manager server system of 27), wherein said at least one portlet comprises a resource de- 

scription framework portlet. 

30) The presentation manager sender system of 27), wherein said at least one portiet comprises an internal network 
information portlet. 

50 

31) The presentation manager server system of 27), further comprising a storage medium having stored thereon 
a plurality of presentation schemes. 

32) The presentation manager server system of 27), wherein said web server comprises a servlet container 

55 

33) The presentation manager server system of 27), wherein said presentation manager comprises a servlet. 

34) The presentation manager server system of 27), further comprising a plurality of user devices coupled to said 
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web server. 

35) A computer program product having stored thereon computer instnjctions for a method, comprising: 
receiving a request from said user device for said data; 

identifying presentation requirements of said user device; and 

selecting a presentation scheme for said data in accordance with said presentation requirements wherein 
upon application of said presentation scheme to said data, new data presentable on said user device is gen- 
erated 

36) A computer program product having stored thereon computer instructions for a method, comprising: 

receiving a request from a user device generated by selection of a portlet identification object on the user 
device; 

transferring said request to a portlet wherein said portlet retrieves data specified in said request over a network 
and further wherein said data has one format in a plurality of source data formats; 

analyzing said request to determine a user data format that is supported by said user device; 

selecting a presentation scheme to convert said data from said source data format to said user data format; and 

converting said data from said source data format to said user data format using said presentation scheme. 

37) A computer program product having stored thereon computer instructions for a method, comprising: 

receiving a request from a user device generated by selection of a portlet identification object on the user 
device by a web server; 

analyzing said request by said web server to deterfhine whether said request is for content associated with a 
portlet; 

transferring said request to a presentation manager upon determining that said request is for said content 
associated with a portlet; 

passing said request to said portlet by said presentation manager wherein said portlet retrieves data specified 
In said request over a network and further wherein said data has a source MIME type; 

analyzing said request to Identify a user MIME type; 

selecting a presentation scheme from a plurality of presentation schemes based upon said user MIME type 
and said source MIME type; and 

converting said data from said source MIME type to said user MIME type using said presentation scheme. 

38) A method for presenting data on a user device with presentation requirements relating to the presentation of 
said data on said user device, comprising the following steps: 

a) receiving a request from said user device for said data by data presentation management means, 

b) identifying said presentation requirements of said user device to said data presentation management means, 

c) selecting a presentation scheme for said data in accordance with said presentation requirements, so that 
said presentation scheme can be applied to said data to create presentable data to allow the presentation of 
said data on said user device. 
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39) A method according to 38), wherein step c) is carried out by said data presentation management means. 

40) A method according to any of the preceding 38) or 39), comprising the following further step: 

a) applying said presentation scheme to said data to create presentable data to allow the presentation of said data 
5 on said user device. 

41) A method according to 40). wherein step d) is carried out by said data presentation management means. 

42) A method according to 41), wherein step d) is carried out by said user device. 

43) A method according to any of 38) to 42), comprising the following step: 

a) transmitting said presentable data to said user device to allow the presentation of said data on said user device. 

44) A method according to any of the preceding 38) to 43), wherein said data are retrieved by said data presentation 
15 management means before the application of said selected presentation scheme. 

45) A method for obtaining data by a user device having presentation requirements relating to the presentation of 
said data on said user device, comprising the following steps: 

20 a) submitting a request by said user device to data presentation management means for obtaining said data 

from said data presentation management means, said request causing the identification of said presentation 
requirements of said user device to said data presentation management means, the selection of a presentation 
scheme for said data in accordance with said presentation requirements of said user device by said data 
presentation management means, said request further causing the application of said selected presentation 

25 scheme to said data to create presentable data, and 

b) receiving In said user device said presentable data to allow the presentation of said data by said user device. 

46) A method for obtaining data by a user device having presentation requirements relating to the presentation of 
30 said data on said user device, comprising the following steps: 

a) submitting a request by said user device to data presentation management means for obtaining said data 
from said data presentation management means, said request causing the identification of said presentation 
requirements of said user device to said data presentation management means and the selection of a pres- 

35 entation scheme for said data in accordance with said presentation requirements of said user device by said 

data presentation management means. 

b) receiving in said user device said selected presentation scheme for said data, 

40 c) applying in said user device said selected presentation scheme on said data to create presentable data. 

47) A method according to 46), wherein said user device receives said data via said data management presentation 
means. 

45 48) A method according to any of 38) to 47), wherein said presentation requirements of said user device are 

determined based on information about said user device. 

49) A method according to any of 38) to 48). wherein said data includes at least one function which may be utilized 
by means of said user device. 

50 

50) A method according to any of 38) to 49), wherein said user device is a computer system including at least a 
processor, a storage medium and an i-/o- interface. 

51) A method according to any of 38) to 50). wherein said data is retrieved via at least one portiet. 

55 

52) A method according to 51), wherein representations of at least two of said portlets are an-anged in tree-like 
organization on said user device. 
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53) A computer program for carrying out a method according to any of the preceding methods on a computer 
system. 

54) A data carrier for storing a computer program for canTing out a method according to any of the preceding 
5 method claims on a computer system. 

55) A method for using a computer system for carrying out a method according to any of the preceding method 
claims. 

10 56) A computer system comprising at least a processor, a memory and an l-/o-lnterface for representing data 

depending on presentation requirements of a user device relating to the presentation of said data on said user 
device, comprising data presentation management means, wherein said data presentation management means 
include: 

15 a) a receiving module for receiving a request of said user device for said data, 

b) an identifying module for identifying said presentation requirements of said user device, and 

c) a selecting module for selecting a presentation scheme for said data in accordance with said presentation 
20 requirements. 

57) A computer system according to 56), wherein said data presentation management means further include: 
a) a retrieving module for retrieving said data. 

25 58) A computer system according to any of 56) or 57), wherein said data presentation management means further 

include: 

a) an applying module for applying said selected presentation scheme to said data to create presentable data 
which may be presented by said user device. 

30 59) A computer system according to any of 56) to 58), wherein said data presentation rhanagement means further 

include: 

a) a transmitting module for transmitting said presentable data to said user device to allow the presentation of said 
data on said user device. 

35 60) A computer system according to any of 56) to 59), wherein said computer system includes a webserver 

61) A computer system according to any of 56) to 60), wherein said retrieving module for retrieving said data 
includes at least one portlet. 

40 62) A computer system according to 61), wherein representations of at least two of said portlets are an-anged in 

a tree-like organization. 

Abstract of CHAPTER D 

45 [1 504] A method for presenting data on a user device with presentation requirements relating to the presentation of 
said data on said user device, comprising the following steps: 

a) receiving a request from said user device for said data by data presentation management means, 

b) identifying said presentation requirements of said user device to said data presentation management means, and 
so c) selecting a presentation scheme for said data in accordance with said presentation requirements, so that said 

presentation scheme can be applied to said data to create presentable data to allow the presentation of said data 
on said user device. 

CHAPTER E 

55 

[1 505] CHAPTER E describes a method and structure for dynamic conversion of data, e.g. in the networt< portal 
system of CHAPTER A. 
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BACKGROUND 
Field 

[1 506] CHAPTER E relates to data format conversion, e.g., in the network portal system of CHAPTER A, and in 
particular to a method for dynamically converting data having a first data format into data having another data format 
or altematively rendering the same data in different vy^ys. 

Description of Related Art 

[1 507] Data is understood to be arrangements of information to t>e processed by a computer system. The arrange- 
ment of inforrhjation Is made in a certain data format. Each data format corresponds to a specific software module or 
groups of software modules, which support the respective data format. Examples of data formats include the ASCII 
format and the HTML-fomnat, both being able to be processed by a group of text processing software modules, or the 
doc-format or the sdw-format, destined to be processed by a specific text processing software module. 
[1 508] Data may be stored on a storage medium, for example, a hard disc, a soft disc or a CD-ROM. If data having 
a certain data fomnat is retrieved by a user, the user must have access to a computer system utilizing a software module, 
which supports the data fomiat of this data. In global business, the number of situations grows where a user wants to 
access data being stored somewhere in a first data format from a computer system supporting data formats that do 
not include this first data format, or from a computer system with limited capabilities, e.g.. no fonts, speech only, that 
will not pemn It viewing all the infomnation. 

[1 509] In the prior art, format conversion programs are known which allow the conversion of data from one specific 
data format to another specific data fomriat. See for example I ntemational Publication Number WO 98/53393 entitied 
"Data Stream Processing on Networked Computer System Lacking Fomnat-Specific Data Processing Resources" of 
TV. Raman dated November 26, 1998. However, each data conversion from one specific data fomriat to anotiier specific 
data format requires a separate converter or in the terms of the cited publication, a parsing server 
[1510] This means that a user who wants to be able to read data existing in a certain data fonmat on computer 
systems supporting other data formats has to make sure that access is provided to a substantial number of converting 
programs when required. Although, many converting programs are meanwhile available via tiie Internet at no or low 
cost, it is nevertheless cumbersome to access these programs when needed. Also, most of these conversion programs 
are available only for desktop systems, and their executables are dependent upon a specific hardware architecture 
and/or operating system. Such conversion programs cannot be used on devices like mobile phones or hand-held 
personal digital assistants. 

[1511] One solution to this problem was to provide a capability to translate a first data fonnat into an intennediate 
data format, and then another capability to translate the intermediate data format into a second data format. An example 
of this approach includes International Publication Number WO 96/3781 7, entitled "System and Method for Converting 
Data From a First Data Fomriat to a Second Data Format," of J. Todd Coleman, published on November 28, 1996. 
However, this system is not useable by someone that does not have computer coding experience. It requires input of 
a series of commands that define the data in detail. In particular, according to Coleman "The user enters a plurality of 
commands referred to as MapTo commands, and these commands specify the mappings between fields or parts of 
tables." 

[1 512] This use of a convei-sion to and from an intermediate data format reduces the total number of converting 
programs required. However, conversion between two data formats that requires the complexity disclosed by Coleman 
is not useful to the average computer user In general, conversion of every data fomnat into and from only one inter- 
mediate format is undesirable. The one intermediate format cannot include all the information required to properiy 
present the data for every desired input or output format. Consequentiy, the quality of the data conversions is limited 
by the functionality of the one intermediate format. 

SUMMARY 

[1 51 3J It is desirable to provide access from an arbitrary computer system to data having an arbitrary data format. 
[1 51 4J According to one embodiment of the present invention, a user transparentiy accesses data having a format 
that is different from formats supported by the user's device. In another embodiment, a first computer system trans- 
parently transcodes data supplied to a second computer system without user intervention. In yet another embodiment, 
a user request access to data, but the user is auttnorized to access only a portion of the source data. Again transparently 
to the user, the source data is rendered into data for which the user is authorized, i.e., the same data is rendered in a 
different way. In each of these embodiments, a filter server generates a filter that performs tiie required task. 
[1515] In one embodiment, when a filter server receives a request for data, a mie set for a plurality of partial filter 



352 



EP 1 126 681 A2 



adapters is retrieved using a filter registry. A filter is built using the rule set. The filter includes a chain of the plurality 
of partial filter adapters. Each partial filter adapter includes a generic format independent interface. The generic format 
independent Interface is used in passing data from one partial filter adapter in the plurality of partial filter adapters to 
another partial filter adapter in the plurality of partial fitter adapters. 

[1 51 6] In the first emtKxiiment described above, the filter that is constructed converts the data into a format that can 
be processed on the user's device. In the second embodiment, the constructed filter is used, for example, to substitute 
information in one document with other Information. In the third embodiment, the constructed filter is used to remove 
data for which the user is not authorized, i.e., the filter renders the source data in a different way to produce tiie data 
accessed by the user. 

[1 517] . In one embodiment, the generic fomiat independent interface is an event-driven interface. One embodiment 
of the event-driven interface is a Simple API for XML interface. 

[1 518] In still another embodiment, the partial filter adapters comprise a general partial filter adapter having func- 
tionality determined by a parameter. For example, the general partial filter adapter comprises an extensible Style sheet 
Language Transformation processor, and the pararrteter comprises an extensible Style sheet Language Transforma- 
tion script. 

[1 51 9] A computer program product, in one embodiment, comprises a medium configured to store or transport com- 
puter readable code for a method comprising: 

receiving a request for data; 

retrieving, from a filter registry in response to the request, a rule set for a plurality of partial filter adapters wherein, 
upon being chained together the plurality of partial filter adapters converts source data to the data; and 

building a filter using the rule set wherein the filter comprises a chain of the plurality of partial filter adapters wherein 
each partial filter adapter includes a generic format independent interface and the generic format independent 
interface is used in passing data from one partial filter adapter in the plurality of partial filter adapters to another 
partial filter adapter In the plurality of partial filter adapters. 

[1 520] A structure, in one embodiment of the present invention includes a partial filter adapter library, and a partial 
filter adapter registry. The partial filter adapter registiv includes a rule set. A filter server is coupled to the partial filter 
adapter registry and to tiie partial filter adapter library. The filter server uses the rule set to build a filter using a plurality 
of partial filter adapters from the partial filter adapter library. Thus, the filter server generates a structure including a 
first partial filter adapter having a generic format independent interface, and a second partial filter adapter having the 
generic format independent interface coupled to the first partial filter adapter. 

[1 521 ] A further method for generating an adapter for converting data from a first data fomiat to a second data format, 
comprises the steps of: 

a) selecting from an adapter library a first partial adapter for converting the data from the first data format to an 
intermediate data fomiat, 

b) selecting from tiie adapter library a second partial adapter for converting the data from the intermediate data 
fonmat to the second data format, and 

c) combining the first partial adapter and the second partial adapter to generate the adapter for converting tiie data 
from the first data format to the second data format. 

[1 522] The method provides access to data having a certain data format regardless of this data fomrtat from a com- 
puter system which is initially not able to handle and process this data format. 

[1 523] In the first two steps of this method a first partial adapter and a second partial adapter are chosen fi-om an 
adapter library, which is a collection of adapters on any suitable storage medium. Each of the partial adapters stored 
in the adapter library is able to convert data from a certain data format into a defined intermediate data format. In many 
instances partial adapters are also able to reconvert data from the intemiediate data fomiat into the above mentioned 
certain data format, that means they woric bi-directional. This intemiediate data format may be any data format. It is 
selected to provide a common basis for converting into and from. For example, the intermediate data format may be 
an extensible markup language (XML). 

[1 524] The first and second partial adapters are selected according to the concrete conversion requirements of the 
Individual case, that means depending on the first and second data format involved. The selected partial adapters are 
combined to form tiie desired adapter for converting data fi-om tiie first data format to the second data format. This 
combination is also called binding. 

[1 525] The combination, that means the binding, of the two partial adapters may be dynamic, that means the adapter 
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will not be stored in the computer system carrying out the conversion of data. Instead, the two partial adapters may 
cooperate by exchanging information in the intermediate data format directly. Therefore, data to be converted from a 
first data format into a second data format need not exist at any time in a memory of the computer system caoTing out 
the conversion in the form of a complete stream or file of data in the intermediate data format. However, pieces of the 

5 stream of file of data may, of course, exist in the intermediate data format at any given point in time. 

[1 526] In an embodiment of this method the adapter is generated in response to a command of a software program 
supporting tiie second data format to access the data t>eing stored in the first data format. This means, the creation of 
the adapter may be on demand, This derfiand may be automatically posed by the software program or it may be posed 
only after user interaction with this software program. 

10 [1 527] In a further embodiment for generating an adapter the second data format may be selected from at least two 
data formats supported by the mentioned software program. The information about the supported data fonmats may 
be given by the software program to the decision device which selects the second data fomnat. This decision device 
may be implemented in hardware or software and may be located on ttie first or the second computer system or at 
any location being accessible to the first or the second computer system. This information about the supported data 

15 format may be given directly. However, it may also be given indirectiy in that the software program communicates to 
the decision device its type or nature and the decision device retiieves the Information about supported data formats 
from a data base or any memory in which this information is present in relation to the obtained information about type 
or nature of the software program. For example, if it is known to the decision device that a certain text processing 
software program supports a certain data format, it may be sufficient to provide this decision device with the name of 

20 the text processing software program in order to give it, indirectly, tiie required information about the supported data 
format. 

[1 528] if more than one data fomnat is supported by the software program requesting access to data being stored in 
a non-supported data format, the selection of the second data format into which the requested data shall t>e converted 
may be based on a selection scheme. This may use, as an example, one or more of the following criteria: storage 

25 space required by the data in each of the data formats supported by the software program, conversion time for the 
data from the first data fomnat into each of ttie data formats supported by the software program. There may be other 
criteria furthering tiie aim of providing quick and easy access witii a good quality to data stored in a computer system. 
[1 529] In the scope there is also provided a method of using an adapter generated as described above for converting 
data from a first data format into a second data format. 

30 [1530] Further, a method for rendering accessible data stored in a first data format in a first computer system to a 
second computer system supporting a second data format is provided, which method comprises at least the following 
steps: 

a) receiving in the first computer system a request from the second computer system for the data, 
35 b) receiving in the first computer system information about at least one data format supported by the second 

computer system, 

c) selecting the second data format, if in step b) the first computer system was infomned about more than one data 
format supported by the second computer system, 

d) comparing in the first computer system tiie first data format with the second data format, 

40 e) generating an adapter for converting the data from the first data format into tiie second data format, if tiie first 

data forniat is incompatible with the second data format, by combining a first partial adapter for tiie transformation 
of data from tiie first data format to an intermediate data format and a second partial adapter for the transformation 
of data from the intermediate data format to the second data format, 

f] converting tiie data in tiie first computer system by means of the generated adapter from tiie first data format 
45 Into the second data forniat, 

g) transmitting the converted data from the first computer system to the second computer system. 

[1 531] The data which shall be accessed is stored in a first data format on a storage medium of the first computer 
system. This storage medium may be any type of memory, including a hard disk, a soft disk, a tape or a CD-ROM. The 

50 . first computer system is a computer system which has access or is able to set up access to this storage medium, for 
example, via a permanent or an intermediate networi< or data channel. In this context a data channel is understood to 
be any real or virtual connection for the transfer of data. This first computer system comprises, besides tiie storage 
medium, at least a processor for converting data, if necessary, fi-om one data format to another data format. The furtiier 
structure and the location of this first computer system is not pertinent to the present invention. The first computer 

55 system may comprise a server with large-scale storage capacity for data and with high-rate data transfer options for 
data not immediately accessible witiiin the first computer system. 

[1 532] The second computer system may be any computer system suitable for processing data, that means for at 
least retrieving, i.e. opening for reading or changing data. The second computer system must be connectable to the 
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first computer system for the transmission of data. This connection can be achieved by any suitable data channel, 
including permanent and temporary data channels, like any kind of real or virtual network. In one example, the first 
and the second computer system may be of comparable size and have comparable tasks in this network, in another 
example, they may have the tasks of a server and a client, respectively. However, it may also be sufficient to employ 
5 removable data carriers, which will be physically exchanged between the first computer system and the second com- 
puter system, as the data connection. It is even possible that the first computer system and the second computer 
system are fully integrated parts of a complete computer solution. They may even employ the same processor and the 
same storiage medium, so that they may as well be considered to be the same computer. 

[1533] The second computer system may support one or several data formats, which may or may not be identical 
10 with the first data fomiat in which the data- which shall be accessed by or via the second computer system - stored on 
the first computer system. 

[1 534] In the first step, the second computer system may request from the first computer system the data to be 
accessed by seruiing a con-esponding request message to the first computer system. This request message may be 
sent by any suitable means, including via the data connection which is provided for exchanging data between the first 

15 and the second computer system. 

[1 535] Then, the first computer system is informed about at least one data format which is supported by the second 
computer system. This information may Cfome from any source. For example, the second computer system may send 
this information, for example, together with the above described request for the data. However, this information may 
as well be present in the first computer system or any computer or storage system accessible for the first computer 

20 system, before the second computer system requests the data from the first computer system. In this case, the first 
computer system may retrieve or obtain the relevant information itself or by any suitable function, as soon as the second 
computer system requests the data. 

[1 536] The second computer systerri may support, as described eariier. one or more data formats. If a plurality of 
data formats Is supported by the second computer system, the first computer system may be informed about only one 

25 or several selected or all of these compatible data formats, depending on the aim of the second computer system, or 
its programmer or user, respectively, as to which data fomriat shall be requested or accepted. For example, the second 
computer systern may work according to the scheme that a certain data format shall t>e preferred, and only in case 
this data format is not available, with or without conversion, then some other data format shall be accepted, that means 
may be requested from a first computer system, for example, a central server unit. The decision about a preferred data 

30 format may fc>e carried out in the second computer system according to suitable criteria, for example, the criteria de- 
scrit>ed below. 

[1 537] The iriformation of the first computer system about any data formats supported by the second computer system 
may be effected indirectly, in that the first computer system merely receives information about a software module on 
the second coniputer system for which or by which the data is requested from the first computer system. In this case, 
35 the first computer system must have access to information as to which data formats are supported by this software 
moduie. This information may be stored in the first computer system, but it may be stored as well outside in a form 
which is accessible to the first computer system. 

[1 538] In the next step, the first computer system may select the second data format into which the requested data 
shall be converted, if the need to do so arises. This step only has to be carried out, if the first computer system was 

40 informed about more than one data format supported by the second computer system. This selection may be made 
arbitrarily, as well as according to any suitable criteria, for example thie following: storage space required by the data 
in each of the data formats supported by the second computer system, transmission time from the first computer system 
to the second computer system for the data in each of the data formats supported by the second computer system, 
conversion time for the data from the first data format into each of the data formats supported by the second computer 

45 system. Other criteria may be more business-oriented, for example, the support of certain, may be own. data formats 
or may consider the quality of the conversion. 

[1 539] After having been informed about or having selected, respectively, the second data fomriat. the first computer 
system compares the first data format, in which the requested data is presently stored on the first computer system, 
with the second data format in which the data format shall be fonA^arded to the second computer system. If these data 
50 formats are not compatible, the first computer system decides to convert the requested data from the first into the 
second data format. 

[1 540] For this conversion the first computer system generates an adapter for converting the required data from the 
first data format into the second data format, as it was described above. 

[1 541 1 The advantage of the present invention is, that the partial adapter library comprises only adapters from certain 
55 data formats to a convenient intermediate data format and vice versa, but not each iand every cross-connecfion from 
any first to any second data format required by prior art solutions. If a new data format should be supported by the 
prior art solution, as many conversion adapters have to be provided as data formats exist. According to the present 
invention, however, only two new adapters have to be added to the existing library, one for converting the new data 



355 



EP 1 126 681 A2 



format into the interrnediate format, another for cx>nverting the intermediate format Into the new data format 
[1 542] The generated adapter generally works as one adapter, that means there will t>e no Intermediate data in the 
Intermediate data format. However, specific reasons may exist to store such an intermediate data in a storage of the 
first computer system. A reason for such a solution may be InsufTicient buffer space in the conversion processor, or, 
5 considering the situation from the point of view of the data to be converted, this data may be too long to be converted 
in one step. 

[1 543] The standard intermediate data format may be an extensible markup language, generally designated with 
the letters XML. It will be understood that the invention is not limited to the present definition of a XML standard language. 
[1 544] After applying the generated adapter, the first computer system transmits the converted data to the second 

10 computer system via any kind of data connection. Herewith, the user of the second computer system is able to access 
the desired data in the required data fomnat without the need to have a variety of converter programs at hand. 
[1545] In the further course of action the generated adapter may be maintained and stored in the first computer 
system or any storage system related to this first computer system. However, it may be advantageous, with respect 
to storage management, to abandon the generated adapter and newly create it if a similar conversion task arises. 

15 [1546] In the scope a method Is also provided for rendering accessible data stored in a first data format In a first 
computer system to a second computer system supporting a second data format, comprising the steps of: 

a) receiving in said first computer system a request from said second computer system for said data, 

b) informing said second computer system about said first data fomnat of said requested data, 

20 c) selecting said second data format, if said second computer system supports more than one data format, 

d) comparing said first data format with said second data format, 

e) generating an adapter for converting said data from said first data format Into said second data format, If said 
first data format is incompatible with said second data format, by combining a first partial adapter for the transfor- 
mation of data from said first data format to an intermediate data format and a second partial adapter for the 

25 transformation of data from said intermediate data format to said second data format, 

f) converting said data by means of said generated adapter from said first data format into said second data format, 

g) accessing said converted data by said second computer system. 

[1 547] Herein, the second computer system chooses among several supported data formats the second data format 
30 into which the data being present in the first data format shall be converted. The Information about the first data format 

in which the requested data are stored may be provided by the first computer system, but it may also come from every 

other source connected. to the second computer system. The comparison step between the first data format and the 

selected second data format may be carried out in the first or the second computer system or on any other computer 

system being accessible either the first or the second computer system. 
35 [1 548] Further, a method for rendering accessible data stored in a first data format in a first computer system to a 

second computer system supporting a second data format is provided, which method comprises at least the following 

steps: 

a) receiving in the first computer system a request from the second computer system for the data, 
40 b) transmitting the requested data from the first computer system to the second computer system, 

c) so that the second computer system is able to select the second data format, if It supports more than one data 
format, 

d) wherein the second computer system Is able to compare the first data format with the second data format, 

e) wherein the second computer system is able to generate an adapter for converting the data from the first data 
45 fonmat intothe second data format, if the first data format is incompatible with the second data format, by operatlvely 

connecting a first partial adapter for the transformation of data from the first data fomiat to an intermediate data 
fonmat and a second partial adapter for the transformation of data from the intermediate data fomnat to the second 
data format, 

f) wherein the second computer system is able to convert the data by means of the generated adapter from the 
50 first data format into the second data format. 

[1 549] The steps of selecting, comparing, generating and converting may be carried out by the first computer system 
or by the second computer system. It may be also possible that these two computer systems cooperate by canying 
out some of the steps in one computer system and some other steps in the other computer system. 
55 [1550] There is also provided a method for using a second computer system supporting a second data format for 
accessing data being stored In a first data format on a first computer system, comprising the following steps: 

a) requesting from the first computer system the data. 
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b) informing the first computer system about at least one data format supported by the second computer system, 

c) so that the first computer system Is able to select the second data format, if it was Informed about more than 
one data format supported by the second computer system. 

d) wherein the first computer system is able to compare the first data format with the second data format. 

5 e) wherein the first computer system is able to generate an adapter for converting the data from the first data 

format into the second data format, if the first data format is incompatible with the second data format, by operatively 
connecting a first partial adapter for the transformation of data from the first data format to an intermediate data 
format and a second partial adapter for the transformation of data from the intemiediate data format to the second 
data format, 

10 f) wherein the first computer system is able to convert the data by means of the generated adapter from the first 

data fonnat into the second data format, 

g) receiving the converted data from the first computer system in the second computer system. 

[1 551] The last described method for using a second computer system requires a second computer system which 
15 Is able to process data, but which may be very limited in Its functionalities. For example, the second computer system 
may be a thin client which cooperates, as described, with a large server fomiing the first computer system. With this 
method of use the second computer system may be used in a particularly advantageous way 
[1 552] There is also provided a method for using a second computer system supporting a second data format for 
accessing data being stored in a first data format on a first computer system, comprising the following steps: 

20 

a) requestirig from the first computer system the data, 

b) receiving the requested data from the first computer system in the second computer system, 

c) selecting the second data format, if the second computer system supports more than one data format, 

d) comparing in the second computer system the first data format with the second data format, 

25 e) generating an adapter for converting the data from the first data format into the second data format, if the first 

data format is incompatible with the second data format, by combining a first partial adapter for the transformation 
of data from the first data format to an intermediate data format and a second partial adapter for the transformation 
of data from the intermediate data format to the second data format, 

f) converting the data in the second computer system by means of the generated adapter from the first data format 
30 into the second data fonnat. 

[1 553] Also, a method may be provided employing an adapter generated by more than two partial adapters. Herein, 
at least one further partial adapter is used for converting said data from said intermediate data format into a further 
intermediate data format, wherein said first partial adapter is able to convert said data from said first data format into 
35 said intermediate data format and said second partial adapter Is able to convert said data from said further intermediate 
data format into said second data format. The number of further partial adapters may be very high and depends on 
the specific implementation requirements for the Inventive mettnod. 

[1 554] The operations may be implemented in a computer program (computer program product), Including compre- 
hensive office applications. A computer program product comprises a medium configured to store or transport computer 
40 readable code, or in which computer readable code may be embedded. Some examples of computer program product 
are: CD-ROM disks, ROM-cards, floppy disks, magnetic tapes, computer hard drives, servers on a network and carrier 
waves and digital signals transmitted over a telecommunication link or networtc connection. 

[1 555] Such a computer program may be stored on any common data carrier like, for example, a floppy disk or a 
compact disk (CD), as well as on any common computer system's storage facilities, like hard disks. Therefore, the 
45 present invention also relates to a data earner for storing a computer program for canrying out the inventive method. 
The present invention also relates to a method for using a standard computer system for carrying out the present 
Inventive metiiod. 

[1 556] Furthemiore, stored data structures are provided, comprising a set of partial adapters, wherein each partial 
adapter of tiie set of partial adapters is capable of converting data between a certain data format and an intermediate 
50 data fonnat. Therein, each partial adapter being capable of converting data between a first data format and the inter- 
mediate data format may be combined with each otiier partial adapter being capable of converting data between a 
second data format and the intemriediate data format in order to produce an adapter being capable of converting data 
between the first data format and the second data format. 

55 
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BRIEF DESCRIPTION OF THE DRAWINGS OF CHAPTER E 
[15571 

Fig. 1 A: is a high level diagram of a computer network system that includes one embodiment of the filter 

server of the present invention. 

Fig. 16: is a high level diagram of a computer system that includes one embodiment of the filter server of 

the present invention. 



Fig. 2 
Fig. 3 
Fig. 4 



Is a block diagram of a filter built according to one embodiment of the present invention. 

is a block diagram of one embodiment of the filter server of the present invention. 

is a process flow diagram of one embodiment of processing a data conversion request by the 
filter server of Figure 3. 



Fig. 5: is a process flow diagram of one embodiment for using the dynamic data conversion process of 

the present invention. 

Figs. 6A to 6C: are three embodiments of filters generated using a plurality of partial filter adapters with a generic 
format independent interface for passing data from one partial filter adapter to the next partial 
filter adapter 

Fig. 7A: is a first embodiment of a use for a filter constructed using the filter sender of Figure 3. 

Fig. 7B: is a second embodiment of a use for a filter constructed using the filter serwer of Figure 3. 

Fig. 7C: is a third embodiment of a use for a filter constructed using the filter server of Figure 3. 

Fig. 70: is a fourth embodiment of a use for a filter constructed using the filter server of Figure 3. 

Fig. 8: schematic diagram of a hardware system for applying the inventive method 

Fig. 9: flow chart representing the method for rendering accessible data stored in a first data fomnat in 

a first computer system to a second computer system supporting a second data format according 
to the present invention 

Fig. 10: flow chart representing the generation of an adapter for converting data from a first data format 

into a second data fomiat according to the present invention 

Fig. 11: flow chart representing the conversion of data from a first data format to a second data format 

using an adapter generated with a method according to the present invention 

Fig. 12: schematic diagram of a client-sender system for carrying out the method steps shown in Fig. 10 

and Fig. 11 

Fig. 13: flow chart representing the steps of the method according to the present invention by employing 

two computer systems 

Fig. 14: flow chart representing the steps of the method according to the present invention by employing 

one computer system 

Fig. . 1 5: flow chart representing the generation of tiie adapter 

Fig. 16: schematic diagram of examples of combinations of partial adapters 

[1558] In the Figures 1 - 16 of CHAPTER E and the following Detailed Description of CHAPTER E, elements with 



358 



EP1 126 681 A2 

the same reference numeral are the same element or a similar element. Also, the first one or two digits of a reference 
numeral for an element indicate the figure in which that element first appeared. Reference numerals do not necessarily 
correspond to the reference numerals used In the further chapters. 

Herein, italics are used only to aid in reading the disclosure. A word in italics and the same word not In italics represent 
5 the same thing and are the same word. 

DETAILED DESCRIPTION 

[1 559] According to one emt>odiment of the present invention, a user can access the user's data or other data of 
10 interest to and available to the user from any one of a plurality of user devices 102A to 102F. When a first computer 
program executing on a user device, e.g., device 102A, issues a request for data, in response to a user input, the 
request is received by a second computer program, e.g., web server 111. executing on another computer system, e. 
g„ server system 100. 

[1560] If the requested data has a fomiat that can be processed by the first computer program, second computer 
15 program 1 11 simply retrieves the requested data and sends that data to user device 1 02A. However, if the requested 
data has a format that cannot be processed by the first computer program, second computer program 111 passes the 
data request to a filter server 120 of this invention. 

[1 561] In one embodiment, as explained more completely below, fitter server 120 determines data formats that can 
be processed by the first computer program. Filter server 120 also determines the data format of the requested data. 
20 Using the two data formats, filter server 120 dynamically creates a data filter that in tum converts the format of the 
requested data to one of the formats that can be processed by the first computer program. 

[1 562] With filter server 1 20, the user is no longer restricted to retrieving data on user devices that support the same 
application that was originally used to store the data. Moreover, the user is unaware that fitter server 120 is utilized, 
because fitter server 120 is automatically called when the services of filter server 120 are required. Consequently, filter 

25 server 120 eliminates prior art limitations on accessing data from a wide variety of user devices. 

[1 563] Filter server 1 20 is used not only to convert documents based upon a request from a user device, but also to 
convert documents in response to a request from another computer system without user interaction. For example, in 
a business-to-business environment, filter server 120 is used to transcode data, which changes the data while the data 
is being processed. For example, a filter supplied by filter sewer 1 20 is used to substitute part numbers in one document 

30 with ttie required order numbers for the supplier 

[1 564] In stilt another application, filter server 120 does not convert a document from a source data format to a target 
data format, but ratiier allows the rendering of the same data In different ways. For example, a user, who is not authorized 
to view a complete spreadsheet, sees only a particular set of rows of the spreadsheet when the complete spreadsheet 
is processed witti a filter supplied by filter server 120. 

35 [1565] For example, in one embodiment, a user may store an address-list as a part of a schedule program via a 
workstation 102C connected to enterprise network 103. The address-list for the schedule prograrn is stored in user 
documents on a storage device 11 3 of server system 100 tiiat also is connected to enterprise network 1 03. The source 
format of the stored address-list is determined by the schedule program. 

[1566] While visiting a friend, the user wants to access the address-list, but the friend has only a home personal 
40 computer (PC) 102D available, which uses a different operating system and a different suite of programs than those 
available to the user via woricstation 102C. Nevertheless, the user is able to access the stored address-list by using a 
browser, the first computer program referred to above, executing on the friend's home personal computer 102D. Via 
an Internet senf ice provider, the user contacts server system 100 and requests the address-list using the browser on 
personal computer 102D. 

45 [1 567] In resf>onse to the user request, in this embodiment, web server 111 sends a request that includes at least 
one MIME type supported by the browser on PC 1 02D and an address of the requested document to fitter server 120. 
As explained more completely below, filter server 120 builds a filter 210 (Fig. 2) that can read the data from address 
list 201 , dynamically convert tiie read data using a partial filter adapter chain 215 to the new format, and then write the 
converted data in the new format so that the data can be sent to the user. 

50 [1 568] More specifically, in response to the request from web server 1 1 1 , filter server 1 20 via conversion service 1 25 
causes a protocol reader 202(Ftg. 2) to be instantiated and uses the protocol reader to access requested document 
201 to determine the format of ttie requested data. With the source document data fomnat and the target document 
data format, i.e. , the MIME type received in the original user request, filter server 1 20 can build a filter 2 1 0 for converting 
the format of source document 20 1 to tie format of the target document. 1 n this example, address-list 20 1 was generated 

55 using a contact manager and so source document 201 has a fomnat that, for purposes of illusti-ation, is called the source 
format. A MIME type in the request, i.e., the target format, was Portable Document Format (PDF), 
[1569] As explained more completely below, in one embodiment, filter server 120 accesses a filter registiv 127 to 
generate a filter map of partial filter adapters that can be chained together to convert the format of address-list 201 to 
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the PDF MIME type specified in the request A filter map is an example of a rule set for constructing a chain of partial 
filter adapters that perform a desired data conversion. 

[1 570] In this example, the map of partial filter adapters includes three partial filter adapters 203 to 205. A first partial 
filter adapter 203 converts data in the source format to data in STAROFFICE Calc format (STAROFFICE is a trademark 
of Sun Microsystems, Inc. of Palo Alto, CA) A second partial filter adapter 204 converts data in STAROFFICE Calc 
format to data in the rich text format (RTF). A third partial filter adapter 205 converts data from the RTF format to the 
target PDF fomnat. 

[15711 Using the filter map, filter server 120 calls a service to instantiate each partial filter adapter in the map, e.g., 
instantiate each of partial filter adapters 203 to 205, using partial filter adapter library 126. Filter server 120 calls another 
service to chain the three partial filter adapters together using a chaining application programming interface of each 
partial filter adapter. 

[1572] In this emt)odiment, filter server 120 via conversion sennce 125 constructs a data filter 210 (Fig. 3) by gluing 
a protocol read and parser unit 202 to an input end 211 of partial filter adapter chain 215 and a byte stream printer and 
protocol writer 206 to an output end 212 of chain 215 and thereby constructs filter 210. In more general, terms a data 
sink is glued to output end 212. The data sink converts the data presented via an event-based API to a byte stream 
that can be used by an application, or other process. 

[1573] In the example of Figure 2, after construction of filter 210, conversion service 125 uses filter 210 to process 
file 201 . Specifically, source file 201 , which was specified in the request from user device 102D. is read by a protocol 
reader, and if necessary, a parser parsers the input data read by the protocol reader to provide an event-based data 
stream to a source format to STAROFFICE Calc partial filter adapter 203. The output data from partial filter adapter 
203 is provided via a generic fomiat independent interface to a STAROFFICE Calc to RTF partial filter adapter 204. 
The output data from filter 204 is provided via the same generic fomnat independent interface to RTF to PDF partial 
filter adapter 205. 

[1 574J The output data from partial filter adapter 205 is passed to byte stream printer and protocol writer 206. The 
byte stream printer converts the PDF data in the event-based API from partial filter adapter 205 to a byte stream and 
the protocol writer writes that byte stream to a memory either for storage or for transfer to user device 102D. In this 
example, filter 210 generates an address-list file 207 with a PDF format. File 207 is returned to web server 111 , which 
in tum sends file 207 to user device 102D for display Thus, the user is able to view the address-list without having 
access to the application that was used to generate the address-list. 

[1 575] One important aspect of this invention is that each partial filter adapter utilizes the same generic format inde- 
pendent interface to receive input data. Format independent here means that the interface is independent of the par- 
ticular source and target formats as well as the underiying data fonnats associated with a particular partial filter adapter 
This allows any one partial fi Iter adapter to be connected to another partial filter adapter without concern for the particular 
underiying format of the data output by the first partial fitter adapter. In one embodiment, as explained more completely 
below, the gieineric format independent interface is a Simple API for XML (SAX) interface, and the data format of the 
input data is XML. The underiying data format is defined by a Document Type Definition (DTD) identifier. 
[1576] In one embodiment, filter 210 is used dynamically, which means that the complete data file is not stored in 
intermediate stages. Rather, the output from a first partial filter adapter is input to a second partial filter adapter before 
all the data has been processed by the first partial filter adapter 

[1 577] As explained more completely below, in one embodiment, each partial filter adapter has two application pro- 
gramming interfaces. A first interface is the generic format independent interface event-based API that pennits transfer 
of data fi-om one partial filter adapter to another partial filter independent of the specific underiying format of the trans- 
fen-ed data. A second interface is a chainable interface that allows chaining the partial filter adapters together. In another 
embodiment, the two interfaces are the same interface. 

[1 578] The combination of the two interfaces for each partial filter adapter permits dynamic building of a wide variety 
of filters. More importantly, data can be passed from one partial filter adapter to another partial fitter adapter within a 
filter without waiting for one partial fitter adapter to convert alt the data from one fomnat to another. This reduces the 
memory requirements for the data conversion. 

[1 579] The previous example assumed that the user requested data for display on user device 1 02D and that the 
user only wanted to view the requested data. IHowever, altemativety, a user may be executing an application 112 or 
other service on server system 100, and the user directs application 112 to open a data file in a format different from 
the formats supported by application 1 12. In this case, the user wants to modify the data and then to store the modified 
data in its original format. 

[1 580] Upon application 112 determining that the requested data file has a format other than a format that can be 
processed by application 112, application 112 issues a request to filter server 120 that proceeds as described above. 
However, in this example, filter server 120 constructs a dynamic fitter that is bi-directional, so that the original format 
of the requested data is changed to a new format using the filter in a first direction. The data in the new format is 
processed using application 112, and then the same dynamic filter is used in a second direction, opposite to the first 
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direction, to store the processed data in the original format. Alternatively, two different fitters coutd be used one for 
each direction. In some embodiments, the bi-directional data conversion may potentially lead to some information loss. 
[1 581] Hence, with filter server 120, a user can access data on Internet 106 and/or enterprise network 103 from 
almost any available device, e.g.. any one of portable computer 102A, a mobile telephone 102B, a workstation 102C. 

5 a home personal computer (PC) 1 02D, a personal digital assistant 102E, or an Internet cafe machine 1 02F. No longer 
is a user limited to using a particular device with pre-installed software to access data with a particular format, or limited 
to using special devices, which support all capabilities needed to process the whole document 
[1 582] As a further example, consider that a user taps an icon displayed on PDA 102E to generate a request for a 
sales report that is stored in a database in enterprise network 103. The request is sent over Internet 106 to server 

10 system 1 00 that, in turn, retrieves the sales report, dynamically builds a filter to convert the format of the sale report 
to another format that can be displayed on PDA 102E, and transmits the converted sales report to be displayed on 
PDA 102E. A similar transaction could be done using Intemet cafe machine 1 02F. or perhaps mobile telephone 102D. 
[1 583] Plurality of devices 102A to 102F is illustrative only and is not intended to limit the invention to the particular 
devices illustrated. The devices could also include, for example, a POTS telephone, a pager, a set-top box connected 

15 to a television, a networic appliance, or any other device that is connectable to a network and can issue a request for 
data, as described more completely below, and display the data received in response to the request. 
[1 584] In one embodiment, a request from a user device 1 02i, where user device 1 02i can be any one of the plurality 
of user devices 102A to 102F. specifies (i) a suitable address to the location where the content associated with the 
request is stored, for example, an address in the form of a uniform resource locator (URL), and (ii) information con- 

20 ceming either the types of data that can be processed and displayed by user device 102i, e.g., MIME types, or alter- 
natively-applications available on the device to process and display data. 

[1 585] In another embodiment, the request includes the data to be converted in place of the storage location address. 
[1 586] Enterprise network 103 is illustrative only of one embodiment of a network. The particular type of network 
connecting a user device 102i to server system 100 is not essential, and may be the Intemet or any other permanent 

25 or temporary network, for example a local area network. 

[1 587] In the embodiment of Figure 1 A, filter server 120 was included in a server system 1 00. In the embodiment of. 
Figure 1B, filter server 120 is included on a user device 102i. In the embodiment of Figure IB, the memory of computer 
system 102i is divided into a volatile memory 110, like a woricing memory, and a non-volatile memory 131, like a hard 
disc. Filter server 120 is stored in memory 110, while partial filter adapter library 126 and filter registry 127 are stored 

30 in non-volatile memory 1 31 . Of course, all or part of filter server 1 20 could also be stored in memory 131 and executed 
directly from memory 131, or alternatively, portions or modules of filter server 120, e.g.. conversion service 125, could 
be loaded in memory 110 and executed as needed. 

[1588] In this example, computer system 102i also includes keyboard 115, and monitor 116, that are connected to 
processor 101 via I/O interface 132. Computer system 100 also may have, for example, a printer 117, a mouse 118, 
35 a scanner 119 and CD-ROM 114 connected to I/O interface 134. Frequently, computer system 102i also is connected 
to a network 103 via I/O interface 134. Optionally, networic 103 can be connected to, or part of a larger network 106, 
for example, the Intemet or a wide area nehvoric. 

[1589] If application 132 that is executing on processor 101 needs access to data that is in a fonnat other than a 
format that can be opened by application 132, application 132 issues a request for the data to filter server 120 that 

40 proceeds as described above in this embodiment. 

[1 590] Figure 3 is a block diagram of modules used in the process of building a chain 360 of partial filter adapters 0 
to N by filter server 120. In this embodiment, in receive request operation 410 (Fig. 4A), conversion service 125 receives 
as a first input one or more data format types 301 that are specified, for example, by a character string identifier like 
a MIME type, or by a Document Type Definition (DTD) identifier from user device 102i, and in one embodiment from 

45 an importer for a target component of user device 102i. Herein, the importer and the target component may be one 
single component. The request from user device 102i and consequently the request to filter server 120 may include 
quality indicators (priority) for the input data format types 301. Conversion service 125 receives, as a second input 
302, a source data identifier, which is illustrated in Figure 3 as a user file ID. This can be a uniform resource locator, 
a document path, or in one emtK>diment. the document itself that is to be converted either as a data stream or in memory. 

50 [1 591] In the above examples, filter registry 127 was described as providing a filter map. However, this is illustrative 
only and is not intended to limit the invention to this particular embodiment, in general, a filter map is an example of a 
set of mles for constructing a filter that converts data from a first format to a second format, or constructing a filter that 
renders the same data in a different way. The set of rules could be defined, for example, using a XML decision tree or 
a computer programming language such as PROLOG. 

55 [1 592] Also, in one embodiment, library 126 includes general partial filter adapters. The function of a general partial 
filter adapter is controlled by a parameter or a set of parameters. One example of a general partial filter adapter is an 
extensible Style sheet Language Transformation (XSLT) processor A XSLT script is used to define how this general 
partial filter adapter, i.e., the XSLT-processor, processes the data. Thus, by providing different scripts, the same general 
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partial filter adapter can be used for different fomnat conversions and/or filtering. In this case, the same general partial 
filter adapter Is reused in building a filter, but the function of each general partial filter adapter In the filter Is controlled 
by a different XSLT saipt. In this case, the XSLT script is the parameter for the partial filter adapter. In this example, 
the set of rules includes an identifier for the XSLT script that Is to be used to construct a particular partial filter adapter. 
5 [1 593] In the embodiment of Figure 3, conversion service 125 sets up a protocol reader 350 in create reader operation 
420 to determine the source data format. Conversion service 125 passes the source data identifier, or at least a part 
of the source data identifier to protocol reader 350. 

[1 594] Protocol reader 350 retrieves the format of the source data. Some protocols like HTTP provide a MIME type 
directly and so protocol reader 350 simply retrieves the MIME type. For other protocols, format detection components. 
10 which read header Information from the source data file itself, are needed in protocol reader 350. Protocol readers are 
known to those of skill in the art In either case, conversion service 125 receives the format of the source data corre- 
sponding to the source data identifier from protocol reader 350. In another embodiment, the source data format is an 
input to conversion service 125. 

[1 595] Upon determining the source data format, in create reader operation 420, processing passes to an optional 
15 create writer operation 420, in one embodiment. At this point, conversion service 125 knows the target data format. 
As explained more completely below, conversion service 125 can transmit the converted data to an importer in a 
number of ways. The output data stream from the last partial filter adapter is presented via an event-based API. Typ- 
ically. a byte stream printer Is needed to convert the data presented via the event-based API to a byte stream that can 
be processed by other than an event-based API. Also, a protocol writer may be needed. Thus, create writer operation 
20 403 creates a byte stream printer and/or protocol writer, if these components are needed to complete the filter for the 
data conversion. If neither of these components is needed, operation 420 transfers processing directly to operation 
440 and othenwise operation 430 transfers processing directly to operation 440. 

[1596] Conversion service 125 calls a chain factory 315 with at least the source data format and the target data 
format in create filter chain operation 440. Chain factory 315 calls filter registry service 325 and provides the source 
25 and target formats to service 325. Filter registry service 325 using filter registry 1 27 finds a chain of partial filter adapters, 
which is suitable for the conversion of data from the source data format to the target data format, e.g., from a first data 
format to a second data format. In another embodiment, service 325 finds a chain of filters to transcode the data, or 
alternatively to render the data in a different way. 

[1597] In one embodiment of filter registry 127, each entry in registry 127 includes a identifier of the partial filter 
30 adapter, the source data format for that partial filter adapter, the target data format for that partial filter adapter, for 
example, by a MIME type or a DTD identifier, and an activation identifier. The entry also may contain quality indicators 
(priorities) as well as other attributes or options such as extract/strip/erase. 

[1 598] The particular chain chosen depends upon the information provided to filter registry service 325 and the 
informatiori in filter registry 127. Note as indicated above, if filter registry service 325 receives more than one target 

35 data format, service 325 uses a selection scheme to select the target data format. 

[1 599] The selection scheme uses, as an example, one or more of the following criterion: storage space required by 
the data in each of the data formats supported by the software program on user device 102i used to process the data; 
and conversion time from the first data format into each of the data formats supported by the software program or 
programs on user device 1 021 . There may be other criteria furthering the aim of providing quick and easy access with 

40 a good quality to data stored in a computer system. If there are no other constraints, a chain with the least number of 
partial filter adapters is selected. In all cases, a descriptive representation of the partial filter adapter chain is returned 
to chain factory 315 by filter registry service 325 in create filter chain operation 440. 

[1600] Next In create filter chain operation 440, chain factory 315 passes the descriptive representation of each 
partial filter adapter in the chain to service manager 320 in a request to activate each partial filter adapter. Service 
45 manager 320 accesses each partial filter adapter in library 126 within component registry 330 and instantiates the 
partial filter adapter, and retums a pointer to the partial filter adapter to chain factory 315. 

[1601] After service manager 320 instantiates each partial filter adapter, chain factory 315 creates a partial filter 
adapter chain 360 by connecting the newly created partial filter adapters together. The chain connections are built by 
using an interface of each partial filter adapter. As explained above, in one embodiment, each partial filter adapter 
50 includes a chainable API and this API is used to connect each partial filter adapter to the next partial filter adapter In 
the chain. 

[1 602] In one embodiment, the chaining is done by setting a Simple API for XML (SAX) interface XDocumentHandler 
(See Table 8) of each successor partial filter adapter to the predecessor's partial filter adapter. One embodiment of the 
methods in the SAX interface XDocumentHandler \s described more completely below. Upon completion of chain 360, 
55 create filter chain operation 440 retums chain 360 to conversion service 125 and processing transfers from operation 
440 to glue filter operation 450. 

[1 603] In glue filter operation 450, conversion service 125 connects protocol reader 350 and parser 351 to input end 
361 of chain 360. Conversion service 125 also connects a data sink 370. e.g., a byte stream printer and protocol writer 
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generated in create writer operation 430 to output end 362 of chain 360 to complete generation of filter 380. 
[1604] In one embodiment, conversion service 125 caches a pointer to completed filter 380 so that any subsequent 
calls that require the data conversion performed by filter 380 can be completed without building another filter. An 
example of such a cache for filter 380 Is presented in Fig. 4B. For this example, it is assumed that filter 380 performs 

5 the dBase to PDF conversion described above. In this embodiment, cache 465 in memory 491 is a two-input look-up 
table. Use of a lookup table is illustrative only and is not intended to limit the invention to this particular embodiment. 
[1605] For two-Input lookup table 465, a first input, the source format, provides an index that Is used to address a 
row of lookup table 465. A second Input, the target fomnat, is another index that is used to address a column of lookup 
table 465. Here, the source fomnat is the format in which the requested data is stored, and the target fomnat is the 

10 fomnat of the data that can be processed by the computer system receiving the data. 

[1 806] The cell of lookup table 465 at the intersection of the addressed row and column contains the pointer to the 
filter the source and target formats. In this example, the pointer to filter 380 is at the intersection of the row for a source 
dBase format and the column for a target PDF format. If the filter generated by filter server 120 is not cached, cache 
filter operation 460 is not included in the process, and processing transfers from glue filter operation directly to con- 

15 version operation 470. 

[1 607] Conversion operation 470 may be performed by conversion service 1 25. In this case, conversion service 1 25 
uses filter 380 to convert the specified file from the source fonnat to the target format. Alternatively, conversion service 
1 25 can return either filter 380 or a pointer to filter 380 to another process or application, and that process or application 
user filter 380 to perform conversion operation 470. 

20 [1608] In conversion operation 470, filter 380 converts data from the first data format to the second data format. 
According to one embodiment of this invention, complete filter 380 is not stored in it entirety all at one time in dynamic 
memory of the computer system carrying out the conversion of data. Instead, each partial filter adapter, in tum, coop- 
erates with the next partial filter adapter by exchanging directly information in an intermediate data format. Therefore, 
as the data is converted from the first data format into the second data format, a complete stream or file of data in the 

25 intermediate data fomnat, or intermediate data fomnats, need not exist at any time in a memory of the computer system 
carrying out the conversion. However, pieces of the stream of file of data in the intermediate data format, of course, 
may exist at any given point in time. 

[1609] In the previous description, each partial filter adapter was described as converting input data in one fomiat 
to input data in another format. However, partial filter adapters are not limited solely to format conversion. Altematively, 

30 a partial filter adapter can strip information contained in the data, which is not relevant for the representation of the 
data in the output data fomnat. For example, If the computer software program supporting the second data format and 
mnning on the second computer system is programmed to exclusively present an outline of the original source data, 
a partial filter adapter is used strip all detailed information from the data, e.g., all but the outline is stripped so that only 
the outline is subsequently processed in the filter of this invention. 

35 [1 61 0] Another example is to remove all layout and formatting information from the data via a partial filter adapter. 
This means that only the filter subsequently processes the content itself. This may be useful, if the computer program 
that requested the data has no capability to use the layout and formatting infomnation. 

[1611] Process 500 (Fig. 5) is one embodiment of a use of method 400. Typically, in source format known check 
operatiori 501, a user application or a browser, executing on a user device 102i, where user device 1021 can be any 

40 one device in the plurality of user devices 102A to 102F, determines whether the format for the user requested data 
(the source format) is known and whether a local application is available, which can read data with the source fomnat 
This can be done by searching a registration database, or simply by trying all available applications. If the source format 
is known arid a local application is available, which can read data with the source format, processing transfers to run 
local application operation 502 on user device 1021, and otherwise to transfer message operation 503. 

45 [1 612] In run local application operation 502, the local application reads the data in the source format and displays 
the data on user device 1021. Upon displaying the data, method 500 Is complete and so processing transfers to end 
505. When it is said that a user device, or in fact any computer system, knows something or takes some action, those 
of skill in the art will understand that this means that an instruction or insbuctions are executed on the device to deter- 
mine what is known or to cause tiie stated actions to be pertormed. 

50 [1613] In transmit message operation 503, user device 102i sends the request for the data to server system 100. 
The information included in the request depends on the results of check operation 501 . The request includes an identifier 
of the requested data, a source fonnat field and a target format field. If the source format is completely unknown, the 
source format field is set to an illegal value, and a list of identifiers of data formats supported by user device 1021 is 
placed in the target format field. Altematively. an identifier for user device 1 02i could be provided. If the source format 

55 is known, but no appropriate application was found on device 1021, a source format identifier is written in the source 
fomnat field. The target format field is completed as just described. The message is transmitted to server system 100. 
[1614] . In this example, it was assumed that tine user only wanted to view the data and so user device 102i only 
needed capability for opening the requested document. If for example, the user was requesting the data with one 
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application, e.g., a browser or viewer, but wanted to edit the document using another application after the document 
was received, the above decision process would be more complex. The application would require logic to make the 
necessary determinations. For example, the decision could be made to use a remote application to process the data 
after the data format conversion, and so a lightweight component would need to be downloaded and the desired format 
5 would depend on the capabilities of the remote application. See for example CHAPTER C. Independent of the decision 
process used on the client side to determine the target format, the message sent by client device 102i specifies at 
least an identifier of the requested data, and an indication of a target forniat. 

[1 61 5] Upon receipt of the message from client device 1 02i, source format Icnown check operation 51 0 determines 
either whether the source fonmat field in the message includes a legal value or whether the format of the source file 

10 can be detected. If either the source format field includes a legal value or the format of the source file can be detected, 
the source format is known and so processing transfers to convert check operation 512. Alternatively, the source format 
is unknown, and check operation 510 transfers to en-or handler operation 504 that temiinates method 500. 
[1616] In process 500. the operations performed on server system 100 could be performed by different modules 
executing on server system 1 00 in a first embodiment, and by a single module in a second embodiment. The particular 

15 module or modules that perfomri the operations of process 500 on server system 100 is not essential to this invention. 
[1617] In search operation 511 , if a user device identifier was provided, operation 511 first obtains information about 
user device 102i and available software on user device 102i. For example, operation 511 retrieves information about 
supported data formats from a database, or from other stored infomriation about the type or nature of the software 
program and user device 1021. For example, if it is known that a text processing software program supports a certain 

20 data format, it may be sufficient to obtain the name of tiie text processing software program from user device 1 02i to 
obtain indirectly the required information about the certain data format supported by the text processing software pro- 
gram from a data source accessible to search operation 511 that is executing on server system 100. 
[1618] When search operation 511 has a set of possible target formats, operation 511 finds a best combination of 
partial filter adapters to convert the data in tiie source format into data in the target format. If no conversion is possible, 

25 the set of partial filter adapters found is an empty set. 

[1 61 9] Thus, on entry to convert check operation 51 2, the data format of tiie requested data is known; the data format 
processing capabilities of user device 1021 are known; and a set of partial filter adapters for converting the data is 
known. If convert check operation 512 determines ttiat the set of partial filter adapters is not empty, check operation 
512 transfers processing to dynamic filter method 400 and othenwise to error handler operation 504. En-or handler 

30 operation 504 temiinates processing because a set of partial filter adapters for use in transforming ttie source data to 
one of the target format supported by user device 102i was not found. 

[1 620] In dynamic filter method 400, a filter is constructed using the set of partial filter adapters, as described above. 
The filter is used to ti^nsform the data from the source format to the target format. Send operation 514 forwards the 
requested and transformed data, in tiiis embodiment, to run local application operation 502 that performs as described 
35 above. 

[1 621 ] In Figures 6A to 6C, examples for converting documents from one source data fomnat into another target data 
format are shown. In Figure 6A, mettiod 400 starts with a document in the Microsoft WinWord format (the WinWord 
format) that was requested for use in an application that uses the RTF format. In ttiis example, method 400 generates 
a filter employing one partial filter adapter for converting the document in the WinWord fomnat into data having the 
40 STAROFFICE-Writer format and another partial filter adapter for converting the data in the STAROFF ICE- Writer format 
into a document having the RTF format. 

[1 622] In the example in Figure 6B, a source document in the STAROFFICE-Writer fomnat is converted into a PDF 
(Portable Document Format) document. Hence, filter method 400 starts witti a document in the StarOffice- Writer format 
that was requested for use in an application that uses tiie PDF format, e.g., the user only wants to view the document. 
45 A first partial filter adapter converts the STAROFFICE-Writer format into a RTF format. A second partial filter adapter 
converts the RTF format into the PDF format. 

[1 623] In Figure 6C, the first data format is WordPerfect 2001 and the second data fomnat is STAROFFICE Writer. 
The first partial filter adapter converts the data fi-om WordPerfect 2001 fomnat to MS Word 2000 fomnat, while the 
second partial filter adapter converts tiie MS Word 2000 format to STAROFFICE Writer format. 
50 [1 624] Figures 7A to 7D are examples of the use of different filters that can be built using filter server 120 of this 
invention. In Figure 7A, thestmcture of a datafile 701 onastorage medium 113 accessible by a first computer system 
720 is modified and provided to an output device 710, e.g., a speaker, a display, or a printer on a second computer 
system 740. 

[1 625] If storage medium 113 is not included within first computer system 720, data file 701 is accessible on demand 
55 via a networtc connection, for example, using special protocols like HTTP or FTP Note that tiie request for data file 
701 could have originated on computer system 720, computer system 740. or anotiier computer system that is not 
shown. If the request originated from a computer system other tiian the computer system tiiat ultimately processes 
the target data, e.g. . system 740, the request included routing information so that data can be routed to the appropriate 



364 



EP1 126 681 A2 



location. 

[1 626] To access data file 701 for further handling and processing, data file 701 Is transferred from storage medium 
113 to first computer system 720. In this emt)odiment, protocol reader 702 reads source data from an external repre- 
sentation of the data, here data file 701 on storage medium 113. into first computer system 720. Specialized protocol 

5 readers for different protocols exist, for example, protocol readers for protocols FILE, HTTP and FTP. respectively. 
[1 627] Protocol reader 702 has an interface, which allows reading the original source data. This interface provides 
access to the requested data file that means to the original source data. An example of this interface is interface 
XlnputStream (See Table 1). Interface XInputStream is an interface for sequentially reading data from a data source. 
Such an interface has at least a method to read data, for example, method readBytes in interface XlnputStream (See 

10 Table 1.). 

[1 628] Parser 703 parses the original source data stream of original data file 701 via the interface provided by protocol 
reader 702. For example, in one embodiment, parser 703 is an XML parser, which disassembles the original source 
data stream into XML tokens and contents. 

[1 629] Parser 703 uses a data sink interface, here for example SAX interface XDocty/ne/ifHand/er (Table 8) , to fonA/ard 
IS the parsed data to a first partial filter adapter component 704. This data sink interface is generic and does not depend 
on the concrete document type of the original source data. In this embodiment, each partial filter adapter, in tum, uses 
the same generic interface XDocumentHandler to pass the data stream to the next partial filter adapter. In this embod- 
iment, XML data is used to implement the generic fomnat independent interface between the partial fitter adapters. 
Specifically, each partial filter adapter component forwards the (partially) converted data to the next partial filter adapter 
20 component in the chain by using interface XDocumentHandler The interfaces between the partial filter adapter com- 
ponents in this chain are the same and independent from the concrete document type. 

[1 630] The use of interface XDocumentHandler in the partial filter adapters is illustrative only and is not intended to 
limit the invention to this specific interface. Other similar interfaces may be used. Each partial filter adapter can be, for 
example, hard coded, or can be implemented by XSLT transformations, using an XSL processor and XSL transforma- 
25 tion descriptions. 

[1 631 j Each of these partial filter adapter components can either convert one format to another format without chang- 
ing the information itself, or can add or reduce the Information contained in the data, for example, by using third data 
sources like databases or reduction rules. 

[1632] In the embodiment of Figure 7A, the last partial filter adapter 705 is adapted to issue a remote call over a 
30 network connection 730 to Inieriace XDocumentHandler oi an importer 712 for a target component 711 . This effectively 
fonvards the converted data directly to output device 710. 

[1633] Importer 712 of target component 711 receives the target data by interface XDocumentHandler and builds 
an intemal representation of the target data, for example a target document. Importer 712 may be part of target com- 
ponent 711. In the present examples, importer 712 is separated to give a clearer picture of the process. 
35 [1634] Importer 712 calls native functions of target component 711 to build the intemal presentation of the target 
data within target component 711 . Interfaces belonging to target component 711 are used in building the intemal pres- 
entation. Each target component 711 has interfaces that are known to those of skill in the art, and so are not considered 
further herein. 

[1 635] Target component 711 , which is used to process the target data, can be, for example, a viewer, an editor or 
40 any other component, which processes data. Target component 711 has its own set of interfaces or other methods of 
receiving the target data. 

[1636] Optionally target component 711 may use a display component to present the document in a rendered (or 
any other) form to the user of second computer system 740. However, output device 710 can be any output device of 
second computer system 740 including, for example, the display or the loudspeaker of a computer or mobile phone. 
45 [1 637] Elements 702 to 704 in Figure 7B are identical to those described above for Figure 7A and so that description 
is incorporated herein by reference. However, in the emt)odiment of Figure 78, partial filter adapter 705 is not configured 
to communicate via a connection to computer system 740. Partial filter adapter 705 provides the converted data to a 
byte stream printer 706 via interface XlnputStream in this example. 

[1638] At this point, the original source data from data file 701 has been converted from the first data format, i.e.. 

50 the original source data fomat, into an event-based target data format. From this event-based target data fomiat, byte 
stream printer 706 converts the intemal representation of the converted data into a representation in the second data 
fonrtat, which can be transferred to second computer system 740 as a binary stream. Byte stream printer 706 has a 
document type independent output interface, which in this embodiment is IrAeriace XActiveDataSource. 
[1 639] Byte stream printer 706 issues a remote call over a networtc connection 731 to interface XOutputStream of a 

55 parser 713 in second computer system 740. This is yet another example for the transfer of the converted data to the 
target system. In this case, simple data blocks can be transmitted over network connection 731. However, direct (un- 
buffered) polling data from remote computer systems may not be extremely efficient. 

[1640] Parser 713 reads the data of the target file from byte stream printer 706 using interface XOutputStream. 
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Parser 713 parses the target data stream of the target file from printer driver 706 and provides data to interface XDocu- 
mentHandler of importer 712. 

Elements 712to710in Figure 7B are identical to those descrit>ed above for Figure 7A and so that description is 
incorporated herein by reference. 

[1641 J Elements 702 to 705 in Figure 7C are similar to those described above for Figure 7B and so that description 
is incorporated herein by reference. However, in the embodiment of Figure 7C, byte stream print 706 receives converted 
data from the prior partial filter adapter by the same document type independent interface, that means interface XDocu- 
menthfandler or a similar interface. 

[1 642] Byte stream printer 706 uses, for example, interface XActiveData Source to write the data in the target data 
format to protocol writer 707. Interface XActiveDataSource is an interface for sequentially writing data to a target com- 
ponent by registering an interface XOtrfpt/fSfream to receive the data. 

[1643] Protocol writer 707 creates a data file from the target data obtained from bit steam printer 706. Depending 
on the protocol used to create the target data file, a different protocol writer component is used. In this embodiment, 
a specialized protocol writer 707 is used on first computer system 720. Protocol writer 707 directly communicates using 
any networtc protocol with a specialized protocol reader 714 on second computer system 740 via network connection 
732. 

[1644] Protocol reader 714 on second computer system 740 reads the target data file into the software system. 
Specialized readers for different protocols may exist, i.e. for FILE, HTTP or FTP Protocol reader 714 uses interface 
XInputStream to provide the target data to parser 713. Elements 713 to 710 function as described above, and that 
description is incorporated herein by reference. 

[1645] Figure 7D illustrates an embodiment of the invention that is similar to the embodiment of Figure 7C. The 
difference is that in the embodiment of Figure 7D, protocol writer 707 and protocol reader 714 do not communicate 
directly. In this example, a file system writer is created which in turn creates the target file with the target data in the 
file system of first computer system 720. 

[1646] The target data file, which is locally stored in first computer system 720, is transferred (copied) to the file 
system on second computer system 740. Parser 713 reads the data of the target file from the protocol reader 714 
using the interface XInputStream. Preexistent software can be used on second computer system 740, if target element 
711 actually contains all of elements 712 to 714. Alternatively, to the depicted usage in two computer systems 720 and 
740, this invention can be used on a single computer system too, as shown in Figure 4. 

[1 647] Table 1 is one embodiment of interface XInputStream that was used in the protocol readers described above. 
Interface XInputStream is a basic interface to read data from a stream. Interface XInputStream inherits from interface 
XInterface that is presented in Table 2. In this embodiment, mieriace XInputStream includes methods readBytes, read- 
SomeBytes, skipBytes. available, and closelnput. As shown in Table 1. each method can raise one of a plurality of 
exceptions including NotConnectedException (Table 6), BufferSizeExceededException (Table 7), and lOException (Ta- 
ble 4). 

[1 648] Method readBytes reads the specified number of bytes in the given sequence. The return value specifies the 
number of bytes, which have been put into the sequence. A difference between input parameter nBytesToRead and 
the retum value indicates that an EOF has been reached. This method blocks the thread until the specified number of 
bytes are available or the EOF is reached. Some implementations must buffer their data to fulfill their specification, 
and if so exception BufferSizeExceededException may be thrown. When the object is not connected to another interface 
XInputStream (the need for a connection must be specified by the service specification) exception NotConnectedEx- 
ception is thrown. Exception lOException is thrown when a general lO error occurs. 

[1 649] Method readSomeBytes reads the available number of bytes and at maximum the number of bytes specified 
by input parameter nMaxBytesToRead. This method blocks the thread until at least one byte is available. This method 
returns the riumber of bytes actually read. If zero is returned, EOF has been reached. The exceptions thrown by this 
method were described above. 

[1 650] Method skipBytes skips the next nBytesToSkip bytes (must be positive). It is up to the implementation whether 
this method is blocking the thread or not. 

[1651] Method available states how many bytes can be read or skipped without blocking. This method offers no 
infomnation on whether the EOF has been reached. 

[1 652) Method closelnput closes the stream. Users must close the stream explicitly when no further reading should 
be done. (There may exist ring references to chained objects that can only be released during this call; Thus, not calling 
this method would result in leak of memory or extemal resources. 
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TABLE 1: INTERFACE XInputStream 



interface XInputStream: 
com: : sun: rstar : : uno: :XInterface 
{ 

long readBytes { [out J sequence<byte> aData, 

[in] long nBytesToRead ) 

raises ( 

com: : sun: : star: : io: : NotConnectedException, 

com: : sun: : star; :io: : Buf f erSizeExceededExceptio 

com: : sun: : star: :io: : lOException) ; 
long readSomeBytes ( [out] sequence<byte> aData, 

[in] long nMaxBytesToRead 

) 

raises ( 

com; : sun: : star: : io; ; NotConnectedException, 

com: : sun: : star: : io: : Buf f erSizeExceededExceptio 

n, 

com: :sun: :star: :io: : lOException ) ; 
void skipBytes( [in] long nBytesToSkip ) 
raises ( 

com: :sun: :star: :io: : NotConnectedException, 

com: : sun: rstar: : io: : Buf f erSizeExceededExceptio 

n, 

com: : sun : : star : : io : : lOException ) ; 
long available 0 
raises ( 

com: : sun : : star : : io: ; NotConnectedException, 

com: : sun: :.star: :io: : lOException ) ; 
void closelnput ( ) 
raises ( 

com: :sun: :star: :io: : NotConnectedException, 

com: : sun: : star : : io : : lOException) ; 
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.}; 



[1 653] Interface XInterface (Table 2) is the base interface for other interfaces and provides lifetime control by refer- 
ence counting. Interface XInterface also provides the possibility of querying for other interfaces of the same logical 
object. Logical object in this case means that the interfaces actually can be supported by intemal, i.e., aggregated, 
physical objects. 

[1 654] Method query Interface in interface XInterface queries for a new Interface to an existing object. Method acquire 
increases a reference counter by one, while method release decreases the reference counter by one. When the ref- 
erence counter reaches a value of zero, the object Is deleted. 

TABLE 2: INTERFACE XInterface 



interface XInterface 

{ 

// 

any querylnterf ace ( [in] type aType ); 
[oneway] void acquire ()/ 
[oneway] void release (); 
} ; 



[1 655] One embodiment of structure Uik is presented in Table 3. 
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TABLE 3: Structure Uik 



/** specifies a universal interface key. 

An UIK is an unambiguous 16-byte value for every 
interface. 
*/ 

struct Uik 
{ 

// 

// specifies a 4 byte data block- 
unsigned long m_Datal; 

// . 

/// specifies a 2 byte data block, 
unsigned short m_Data2; 

// 

/// specifies a 2 byte data block, 
unsigned short m_Data3; 

// 



/// specifies a A byte data block, 
unsigned long m__Data4; 

// 



/// specifies a 4 byte data block. 
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unsigned long m_Data5; 




); 









[1 656] Exception lOException (Table 4) in interfaces XInputStream (Table 1), and XOutputStream (Table 12) inherits 
from exception Exception (Table 5). Exception lOException is thrown when an input or output en-or has occurred. 



TABLE 4: EXCEPTION lOException 



exception lOException: 
com: : sun : : star : : uno : : Exception 
{ 



[1 6571 Exception Exception is the basic exception. All exceptions are derived from this exception. Message specifies 
a detailed message of the exception or an empty string if the callee does not describe the exception. Context is an 
object that describes the reason for the exception. Context may be NULL if the callee does not describe the exception. 



TABLE 5: EXCEPTION Exception 



exception Exception 
{ 

string Message; 

com: :sun: :star: :uno: :XInterface Context; 
}; 
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[16581 Exception NotConnectedException (Table6) in interfaces X/npirfSfream (Table 1), andXOufpirfSfream(Table 
12) inherits from exception lOException (Table 4). Exception NotConnectedException is thrown when a read/write 
operation Is tried on an instance that has not been chained properiy. 



TABLE 6: EXCEPTION NotConnectedException 



10 



15 



20 



exception NotConnectedException: 



com: : sun : : star : : io : : lOException 



}; 



25 



[16591 Exception BufferSizeExceeded Exception (Table 7) in interfaces X/npufSfream (Table 1), and XOutputStream 
(Table 12) inherits from exception lOException (Table 4). Exception BufferSizeExceeded Exception is thrown by in- 
stances, which need to buffer data. This exception indicates that not enough system resources are available for ex- 
tending the buffer. This exception May also indicate that the internal buffer has grown to a larger size than 2 GBytes. 
Some current implementations do not support larger buffers. 



30 . TABLE 7: EXCEPTION Buf f erSizeExceededException 



exception Buf f erSizeExceededException: 
com: rsun: : star: : io: : lOException 
{ 

); 



45 [1 660] Interface XDocumentHandler (Table 8) also inherits from interface XInterface (Table 2). Interface XDocumen- 
tHandler receives notification of general document events. In this embodiment, interface XDocumentHandler includes 
methods startDocument, endDocument, startElement, endElement, characters. ignorableWhitespace, processingln- 
stnjction, and setDocumentLocator. Each of these methods can raise an exception SAXException. One embodiment 
of exception SAXException is presented in Table 9. 

50 [1 661 1 Method startDocument receives notification of the beginning of a document. Method endDocument receives 
notification of the end of a document. 

[1662] Method startElement receives notification of the beginning of an element. Input parameter aName contains 
the name of the tag. Input parameter xAttribs contains an interface to the list of attributes given in the tag. Note that 
for every call of the method, the same instance may be passed. So one must make copy of the instance to store the 
55 infomnation. 

[1 663] Method endElement receives notification of the end of an element. Method characters receives notification 
of character data. Method ignorableWhjtespace receives notification of white space that can be ignored. Method 
processinglnstruction receives notification of a processing instruction. Method setDocumentLocator receives an object 
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for locating the origin of SAX document events. 

TABLE 8: Interface XDocumentHandler 



interface XDocumentHandler: 

com: : sun: : star: : uno: rXInterf ace 

{ 

void startDocument ( ) 
raises ( 

com: : sun: : star: :xml: : sax: : SAXException ) ; 
void endDocument ( ) 
raises ( 

com: :sun: :star: :xml: :sax: : SAXException ) ; 
void startElement { [in] string aName, 

[in] com; : sun: : star : : xml : : sax : :XAttributeList 
xAttribs ) 

raises ( 

com: : sun : : star ; : xml : : sax : : SAXException ) ; 
void endElement ( [in] string aName ) 
raises ( 

com: : sun: : star : : xml : : sax: : SAXException ) ; 
void characters { [in] string aChars ) 
raises ( 

com: : sun: : star : : xml : : sax: : SAXException ) ; 

void ignorableWhitespace ( [in] string aWhitespaces 
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10 



20 



raises{ 

com: :sun: : star: :xml: :sax: : SAXException ) ; 

void processlnglnstruction ( [in] string aTarget, 

[in] string aData ) 

raises ( 

com: : sun: rstar: :xinl: :sax: : SAXException ) ; 
void setDocumentLocator ( 

[in] com: : sun: : star: :xinl: :sax: :XLocator xLocator ) 
raises ( 

com: :sun: :star: :xml: :sax: : SAXException ) ; 
); 



25 



[1664] Exception SAXException also inherits from exception Exception (Table 5). Exception SAXException encap- 
sulates the details of an XML parse error or warning. 



TABLE 9: EXCEPTION SAXException 



30 



35 



40 



exception SAXException: 
com: ;sun: :star: :uno: : Exception 
{ 

/*•* This field may contain a wrapped exception 

V 

any WrappedException; 



45 
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[1665] Interface XAttributeUst Is used in method startElement of interface XDocumentHand!er (Table 8). Interface 
XAffnbtrfeL/sr inherits from Interface X/nferfece (Table 2). I nterfaceX/\ttnbtrfeL/sf specifies an element's attributes. This 
interface describes a name-type-value triple, which describe a single attribute of a tag. 

[1 666] Method getLength returns the number of attributes In this list. Method getNameBylndex retums the name of 
an attribute In this list by position. Method getTypeBy Index retums the type of an attribute in the list by position. Non- 
validating parsers may return CDATA only. Method getTypeByName retums the type of an attribute in the list by name. 
Non-validating parsers may return CDATA only Method getValueBy Index retums the value of an attribute in the list by 
position. Method getValueByName retums the value of an attribute in the list by name. 



55 
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TABLE 10: INTERFACE XAttributeList 



interface XAttributeList: 



com: :sun: :star: :uno: :XInterface 

{ 

short getLength ( ) ; 

string getNameBylndex { {in] short i ); 
string getTypeBylndex ( [in] short i ); 
string getTypeByName ( [in] string aName ); 
string getValueBylndex ( [in] short i lu- 
string getValueByName ( [in] string aName ); 
}; 



[1 667J Interface XLocatohs used in method setDocumentLocator of interface XDocumenfHa/7£y/er(Table 8) . Interface 
XLocator inherits from interface XInterface (Table 2). 

[1 668] Interface XLocator makes it possible to associate a SAX event with a document location. 

[1 669] Method getColumnNumber returns the column number where the current document event ends. Method get- 

LineNumber returns the line number where the current document event ends. Method getPublicId retums the public 

identifier for the current document event. Method getSystem ID returns the system identifier for the cun^ent document 

event. 



TABLE 11: INTERFACE XLocator 



interface XLocator: 
com: : sun; : star: : uno: :XInterf ace 
{ 

long getColumnNumber ( ) ; 
long getLineNumber () ; 
string getPublicId {) ; 
string getSystemId ( ) ; 
}; 



[1670] Interface XOutputStream Inherits from interface XInterface that is presented in Table 2. Interface XOutput- 
Stream is the basic interface to write data to a stream. In this embodiment, inXeriace XOutputStream includes methods 
writeBytes, flush, and closeOutput that are each briefly described within Table 12. As shown in Table 12, each method 
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can raise one of a plurality of exceptions including NotConnectedException (Table 6), BufferSizeExceeded Exception 
(Table 7), and lOException (Table 4). 

[1671] Method writeBytes writes the whole sequence to the stream. (Blocking call.) Method flush flushes any data 
that may exist in buffers out of the stream. Method doseOutput is called to indicate that all data has been written. If 
this method is not yet been called, no attached interface XInputStream receives an EOF signal. No further bytes may 
be written after this method has been called. 

TABLE 12: INTERFACE XOutputStream 



interface XOutputStream: 

com: :sun: :star: :uno: :XInterface 

{ 

void writeBytes ( [in] sequence<byte> aData ) 
raises ( 

com: :sun: :star: :io: : NotConnectedException, 

com: :sun: :star: :io: : Buf ferSizeExceededExcepti 

on, 

com: ; sun : : star : : io: : lOException) ; 
void flush 0 
raises ( 

com: : sun: : star : : io: : NotConnectedException, 

com: : sun: : star : : io: : Buf ferSizeExceededExcepti 

on, 

com: : sun : : star : : io : : lOException) ; 
void closeOutput () 
raises ( 

com: : sun: : star: : io: : NotConnectedException, 

com: :sun: rstar: :io: : Buf ferSizeExceededExcepti 

on, 

com: : sun: : star: : io: : lOException) ; 

}; 

L : I 

[1 6721 Interface XActiveDataSource (Table 1 3) Inherits from interface XInterface that is presented in Table 2. In this 
embodiment, Meriace XActiveDataSource includes method setOutputStream and method getOutputStream. Method 
setOutputStream plugs the output stream, while method getOutputStream returns the plugged stream. 
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INTERFACE XActiveDataSource 



interface XActiveDataSource : 

com: : sun: : star: ; uno: :XInterface 
void setOutputStream( [in] 

com: : sun: : star :: io: rXOutputStream aStream ); 
com: : sun: : star: : io: : XOutputStream getOutputStream ( ) ; 
}; 



[1 673) Herein, a computer program product comprises a medium configured to store or transport computer readable 
code for alt or any part of filter server 120 and in particular in which computer readable code for conversion service 
125 is stored. Some examples of computer program products are CD-ROM discs, ROM cards, floppy discs, magnetic 
tapes, computer hard drives, servers on a networic and signals transmitted over a networi^ representing computer 
readable program code. 

[1674] As illustrated in Figure 1B, this storage medium may belong to computer system 1021 itself. However, the 
storage medium also may t>e removed from computer system 1 02i. For example, conversion service 125 may be stored 
in memory 184 that is physically located in a location different from processor 101. The only requirement is that proc- 
essor 101 is coupled to the memory. This could be accomplished in a client-server system, e.g. as in Figure 1A, or 
alternatively via a connection to another computer via modems and analog lines, or digital interfaces and a digital 
carrier line. ' 

[1 675] Herein, a computer memory refers to a volatile memory, a non-volatile memory, or a combination of the two. 
Similarly, a computer input unit and a display unit refers to the features providing the required functionality to input the 
information described herein, and to display the information described herein, respectively, in any one of the afore- 
mentioned or equivalent devices. 

[1 676] In view of this disclosure, filter server 120 can be implemented in a wide variety of computer system config- 
urations. In addition, filter sender 120 could be stored as different modules in memories of different devices. For example, 
conversion service 125 could initially be stored in a server computer 100, and then as necessary, a module of conversion 
service 125 could be transferred to a client device 1021 and executed on client device 102i. Consequently part of 
conversion service 125 would be executed on the server processor, and another part would be executed on the proc- 
essor of client device 102i. In view of this disclosure, those of skill in the art can Implement the invention in a wide- 
variety of physical hardware configurations using an operating system and computer programming language of interest 
to the user. 

[1 677] Filter server 1 20 of the present invention may be implemented in a computer program including comprehensive 
office application STAROFFICE that is available from Sun Microsystems, Inc. of Palo Alto, CA. (STAROFFICE is a 
trademaric of Sun Microsystems.) Such a computer program may be stored on any common data earner like, for ex- 
ample, a floppy disc or a compact disc (CD), as well as on any common computer system's storage facilities like hard 
discs. Therefore, one embodiment of the present invention also relates to a data carrier for storing a computer program 
for carrying out the inventive method. Another embodiment of the present invention also relates to a method for using 
a computer system for canying out the presented inventive method. In yet another embodiment of the present invention 
further a computer system includes a storage medium on which a computer program for carrying out the presented 
inventive method is stored. 

[1678] In the following, further embodiments of the invention will be described with respect to Figs. 8 - 16. 
[1679) First, an embodiment of the invention will be described with respect to Fig. 8. Fig. 8 shows an example for a 
second computer system 801 suitable to be used in the scope of the present invention. This second computer system 
801 comprises a processor 802, memories 803, 804 and an i/o interface 805. The memory of the second computer 
system 801 is divided in this example into a volatile memory 803, like a working memory, and a non-volatile memory 
804, like a hard disk. Via the i/o interface 805 the second computer system 801 may, for example, be connected with 
input/output devices 806 to 811 . Common input/output devices are a keyboard 806, a monitor 807 and a printer 808. 
Other input devices like a mouse 809, a scanner 810 and a CD-ROM 811 are also possible. Frequently, the second 
computer system 801 is also connected to a network 812 via this i/o interface 805. A first computer system 813 may 
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be connected to the second computer system 801 via this network 812. This first computer system 813 may comprise 
as well a processor 814. memories 815. 816 and an i/o interface 817. 

[1 680] It is desirable to provide access to data having a certain data fomnat regardless of this data format from a 
computer system which is Initially not able to handle and process this data format. The method according to the present 
invention may be em ployed, for example, for enabling a user to access his data by means of different computer systems. 
A user may store, for example, an address-list as a part of a schedule program via his second computer system 801, 
in this example a standard personal computer in his olTice, on a first computer system 813, in this example a central 
server. The corresponding data may be stored In a first data format which is specific for the employed schedule program. 
[1 681 1 In the following example, the user wants to access this address list via another second computer system 801 . 
for example a standard personal computer in the office of a customer. It is understood that the method according to 
the present invention is not limited to standard personal computers. Any other computer systems like, for example, 
laptops, handheld computers and mobile phones can also be employed as second computer systems 801 . In the case 
that the actually used second computer system 801 may not comprise the specific schedule program, prior art systems 
would have difficulty in providing the user access to the address-list. However, if the method according to the present 
invention is applied the user will get easy access to the address-list, although the actually used second computer 
system 801 does not have the specific schedule program nomriaily required to access the address list. 
[1682] The flow chart in Fig. 9 represents the steps of the present example. In a first step 900 the user may contact 
the first computer system 813 in order to open the specific address list. The first computer system 813 and the second 
computer system 801 will start a communication in order to select a data format for the requested data. This may take 
place, for example, by two different ways: 

[1 683] If the second computer system 801 knows that the requested data is formatted in a certain first data format 
the method will carry out the step 901a in Fig. 9. In this step the second computer system 801 will inspect the software 
programs which are available to the second computer system 801 in order to find software programs which support 
the first data format of the requested data or a compatible data format. Thereafter, the second computer system 801 
will inform the first computer system 813 whether the second computer system 801 is able to open the requested data 
in the first data format, or if the first computer system 81 3 may have to convert the data from the first data format into 
a second data format supported by the second computer system 801. If the second computer system 801 has no 
access to a software program which supports the first data format of the requested data, the second computer system 
801 will inform in step 902a the first computer system 813 about one or more second data fomiats supported by it. 
Based on this additional information the first computer system 813 may provide the requested data directly to the 
second computer system 801 - if the second computer system 801 supports the first data format - or the first computer 
system 813 may first convert the requested data in a second data format - if the second computer system 801 does 
not support the first data format as will be described below. 

[1 684] If the second computer system 801 does not know the first data format of the requested data, the first computer 
system 813 has to decide whether the requested data may have to be converted or not. In order to find out which data 
fomnats are supported by the second computer system 801 the first computer system 813 may start a function for 
searching the software programs available to the second computer system 801, represented by step 901b in Fig. 9. 
The result of this search function may be the information about softvyare programs available to the second computer 
system 801 or the supported data formats, respectively. The result of this search function may be evaluated in step 
902b in the first computer system 813 and based on ttiis result tiie first computer system 8 1 3 may convert the requested 
data in the second data format. 

[1 685] In order to convert the requested data in the second data forniat ttie first computer system 813 will generate 
dynamically an adapter for converting data from the first data fomiat into the second data format. According to the 
present invention such a converting step is earned out by employing an intemiediate data format, especially an XML 
format. 

[1 686] The first computer system 8 1 3 may have access to a data base with adapters between the first and the second 
data fomiat, respectively, and tine standard data format, in tills example a XML fomiat. Such adapters allow to convert 
data from the first or second data format, respectively, into a XML fomiat and also to convert data from a XML fomiat 
into the first and second data format, respectively. 

[1 687] After the first computer system 8 1 3 has specified in step 902a or in step 902b the second data fomiat the first 
computer system 813 may select in step 903 from ttie data base a first adapter which enables to convert data from 
the first data fomiat into a XML fonmat and a second adapter which enables to convert data from a XML format into 
the second data format. These two adapters may be combined in step 904 in a way ttiat the data may be converted 
from the first data format into tiie second data format, without tiie existence of the data in the intermediate data fomiat, 
a XML format in this example. 

[1 688] These adapters may be employed for the converting in step 905 of tiie requested data into the second data 
format. Thereafter, the converted data may be transmitted in step 906 to the second computer system 801 in order to 
open this data on the second computer system 801 . 
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[1 689] Fig. 10 shows in a flow chart the steps for generating an adapter for converting data t>etng formated in a first 
data format into data being fonnated In a second data format 

[1690] In a first step 1000 a first partial adapter is selected from an adapter library. The first partial adapter is a 
software module which is able to convert data from a first data fomnat into the intermediate data foniiat and vice versa. 
5 The first partial adapter may be bidirectional for conversion in two directions or unidirectional for conversion only in 
one direction. The selection of tine first partial adapter requires information as to the first data format of the data. 
Furthermore, infonnation will be required about ttie intenmediate data format, if the intermediate data format is not yet 
determined for the inventive method. This information may be received and the selection carried out by a suitable 
software program. 

10 [1 691] In a second step 1001 the second partial adapter is selected from the adapter library. The explanations given 
above for the selection of the first partial adapter apply here as well. The sequence of the selection of the first and the 
second partial adapter is not relevant to the present invention, it will be determined according to practical considerations. 
[1692] Finally, in a third step 1002 the first partial adapter and the second partial adapter are combined, so tiiat the 
desired adapter for converting data from a first data format into a second data format is generated. This combination 

15 may be achieved by a software program which is informed about tiie selected adapters and their address in a storage 
or memory medium. For example, the above described software program which carries out ttie selection of the first 
and the second partial adapter may also carry out tiieir combination. Fig. 12. which will be described below, shows a 
possible mechanism of these selection and combination steps. 

[1 693] Fig. 11 exemplary shows in a flow chart the conversion of data from a first data fomnat into a second data 

20 fonnat. as it is carried out by the inventive method. 

[1694] In a first step 1100 tiie data in the first data format which shall be converted is loaded onto the computer 
system on which the conversion will be carried out. Loading of the data means to make it available for further processing 
by the adapter which will also be available on the computer system which converts the data. The loading may require 
the transfer of the data from another computer system or storage medium, for example, a data base separated from 

25 the computer system on which the conversion will be carried out, because the data to be converted need not be stored 
on this computer system. This transfer may be earned out via any suitable data channel, be it permanent or temporary. 
[1695] In step 1101 the data to be converted is read by the generated adapter as a whole or part by part. In step 

1102 the infonnation contained in the data which is not relevant for the representation of the data in the second data 
fomnat may be stripped and disregarded in the further process of conversion. Such information may, for example, by 

30 layout commands which are meaningful in the first data fomnat, but are meaningless in the second data fomiat. In step 

1103 the remaining content of the data, i.e. the non-stripped infomnation, will be converted from the first data format 
into the second data format using the generated adapter. The adapter may be generated, as explained above, on the 
fly, tiiat means it will be generated on demand and it need not be stored, unless a storage during the conversion of the 
data in the computer system is advantageous for some reason, for example, due to the size of the adapter in relation 

35 to the working memory of the computer system's processor. 

[1696] Finally, in step 1104 the converted data is stored in a storage medium accessible to the computer system 
which carried out the conversion of the data. Herewith, the data is accessible to users in the second data format. 
[1 697] The generation of an adapter and the conversion of data witii the generated adapter according to the present 
Invention, as they were described in Fig. 10 and Fig. *11 above, may be carried out on a client-server system as it is 

40 shown in Fig. 12. 

[1698] Fig. 12 shows a client 1200. for example, a laptop computer which has access, for example, via a real or 
virtual network, to a server 1201 which has in turn access to a storage medium 1202. A software program 1203 runs 
on the client 1200. This software program 1203 desires access to data 1204 which is stored on storage medium 1202. 
The software program 1203 supports a second data format, but not the first data format in which the data 1204 is stored 
45 on the storage medium 1202. Therefore, the software program 1203 is not able to directiy access the data 1204 on 
the storage medium 1202. 

[1699] In order to render ttie data 1204 accessible to the software program 1203 the server 1201 has access to an 

extemal data base 1 205 containing a library of partial adapters 1 206, 1207 A software program 1 208 on the server 

1201 Is able to generate the adapter required for converting the data 1204 from the first data fomnat into the second 
50 datafomiat. A further software program 1209 on the server 1201 serves for applying the generated adapter and thereby 
provides the converted data 1204, which may then be retumed to the client 1200. 

[1700] According to the present Invention the software program 1203 on the client 1200 contacts the software pro- 
gram 1209 on the sender 1201 in order to obtain access to the data 1204 stored on the storage medium 1202. The 
software program 1209 may ask the software program 1 203 which has issued the request for access which data format 
55 it can or would like to support. It may further ask the storage medium 1202 in which data format the data 1204 is 
available. Having so determined the first data format - In which the data 1204 Is stored on storage medium 1202 - and 
the second data format • which is supported or required by the software program 1203 - the software program 1209 
may request from the software program 1208 an adapter allowing the conversion of data from the first data format to 
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the second data format. The software program 1208 will, based on this infomriatjon, contact the data base 1205 and 
select the first partial adapter 1206 - which is able to convert between the first data format and the intemiediate data 
fomnat - and a second partial adapter 1207 - which is able to convert between the intermediate data format and the 
second data format - and combine both in order to generate the desired adapter. This adapter will then be provided 
5 for application from the software program 1208 to the software program 1209, where the conversion of the data 1204 
be effected. This conversion requires that the data 1204 is transferred from the storage medium 1202 to the software 
program 1 209 on the sender 1201. The converted data will then be sent to the software program 1 203 on the client 1 200. 
[1 701] Examples for the implementation of the present invention are in the following described in more detail along 
Figures 1 3 to 1 5 and Table 1 . 

10 [1 702) in Fig. 13 the data transfer and the data format filtering, that means the data conversion process employing 
a first and a second computer system is described. 

[1 703] Original source data is present in its source data format, above referred to as the first data format, on a first 
computer system. It shall be converted into a target data format, above refen^ed to as the second data format, so that 
it is accessible by a second computer system which supports the second, but not the first data format This conversion 
15 is effected via an intermediate data format. This process will be descrit>ed in more detail in the following. 

D1: storage medium for original source data 

[1 704] The original source data are the data stored on the first computer system and to be accessed by the second 
20 computer system. Here, this data is stored on a storage medium D1 of the first computer system in the form of a data 
file. Alternatively, the data could be procured on demand via a network connection, for example, using special protocols 
like HTTP or FTP. The data could also be stored on a third computer system which is accessible for the first or the 
second computer system. 

25 t1 . 1 : transfer of the original source data to the protocol reader PR1 

[1 705] In order to access the data file for further handling and processing the data file is transferred from the storage 
medium D1 of the first computer system to a protocol reader PR1, which may also be located on the first computer 
system. 

30 

PR1: Protocol Reader 1 

[1706] The protocol reader PR1 on the first computer system reads source data from an extemal representation of 
data, here the storage medium D1. into the first computer system. Specialized protocol readers for different protocols 
35 may exist, for example, for FILE, HTTP or FTP. 

c1 . 1 : reading the original source data 

[1 707] An interface which allows reading the original source data is provided by the protocol reader PR1 . This inter- 
40 face provides access to the requested data file, that means to the original source data. An example for such interface 
is XinputStream. 

[1708] The XinputStream is an Interface for sequentially reading data from a data source. Such an interface has at 
least a method to read data, for example, the following: 

void XinputStream: readData( [in] sequence<byte> a Buffer ) 
45 throws 10 Exception; 

Pa1 (Parser 1); parsing the structure of the original source data 

[1709] The parser Pa1 parses the original source data stream of the original data file. For example, this can be an 
50 XML parser, which disassembles the original source data stream into XML tokens and contents. The XinputStream 
offered by PR1 and mentioned in c1.1 is used to access the original source data. 

c1 .2: fonvarding parsed data to filter A 

55 [1710] The parser Pal uses a data sink interface, here for example an SAX interface XdocumentHandler as will be 
described in Table 1, to forward the parsed data to the filler A. This interface is generic and not dependent on the 
concrete document type of the original source data. 
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Filter A-2: filtering data 

[1711] Multiple filter components A to Z can be chained to convert the original source data fi'om the source data 
format into a fomiat which is readable by the target component, therefore called target data fomnat. Each of these filters 
5 provides a XDocumentHandier interface which allows to con-espond with the next filter. For example, filter A provides 
a XDocumentHandier interiface for communicating with filter B» while filter B provides a XDocumentHandier interface 
for dealing with filter C, etc.. Instead of XDocumentHandier interfaces similar interfaces may be used. Each filter can 
be, for example, ''hard coded* or be implemented by XSLT transformations, using an XSL processor and XSL trans- 
formation descriptions. Each of these filter components can either transfer one format to another without changing the 
10 information itself, or can add or reduce the rnfomiation contained in the data, for example, by using third data sources 
like databases or reduction rules. In the following, two examples for filtering are described: 

First Filtering Example: outline 

[1712] One example for data filtering within a filter, like the above filters A to Z, is to strip all detail information ft-om 
the information contained in the data. This means to forward, for example, only the headings within the text or the titles 
of diagrams, pictures or tables. This is useful, if the target component TC - above referred to as the computer software 
program supporting the second data format and running on the second computer system which requests the original 
source data - Is able or programmed to exclusively present an outline of the original source data. This stripping of 
detailed data reduces the amount of data to be transferred in rt or rcl to rc3. 

Second Filtering Example: layout stripping 

[1713] Another example for data filtering is to remove all layout and fonnatling informafion from the data. This means 
25 to forward only the content itself. This may be useful, if the target component TC has no capabilities to display such 
layouts and fomnattings. Again, the transferred amount of data in rt or rcl to rc3 may be reduced. 

cl.3: fonwarding data between filter components 

30 [1714] Each filter component fonwards the (partially) converted data to the next filter component by using the XDocu- 
mentHandier interface (or similar) of the succeeding filter component. The interfaces between the filter components in 
this chain are the same and independent from the concrete document type. 

c1.4: fonvarding data from the last filter component to the printer component 

[1715] The last filter component within the chain of filter components on the first computer system fonwards the 
(completely) converted data to the printer Pr by the same interface, that means XDocumentHandier or similar. At this 
point the original source data has been completely converted from the first data format, i.e. the original source data 
format, into the intemnediate data format. From this data forniat it shall be further converted to the second data format 
requested by the second computer system or the target component TC, i.e. the software program running on the second 
computer system which wants to access the original source data, respectively. 

Pr (Printer): converting the data into target data 

45 [1716] This is a component which converts the intemal representation of the converted data in the intermediate data 
format into a representation in the second data fomiat which can be transferred to the second computer system, be- 
cause the second data format is supported by this second computer system. For instance, an XML printer can be used. 
This component also offers the XDocumentHandier interface (or similar) to receive the data. Thus it has a document 
type independent interface. For instance, the printer Pr can create a text representation of an XML document, a PDF 

50 document or a document in the proprietary file format of the target component TC. 

[1717] Referring to the above used terminology, in this example some or alt filters of the chain of filters A to Z would 
be considered as the first partial adapter, while the printer Pr would be considered to be the second partial adapter 
Whether more or less filters of the chain of filters would have to be considered to fomn the first partial adapter depends 
on the nature of the filters in the filter chain. If those filters exclusively serve the conversion of the data from the first 

55 into the second data format, then the full chain of filters could be regarded as the first partial adapter. However. If some 
filters in the chain of filters are dedicated to other tasks, for example, stripping information beyond the need specified 
by the target data format, these filters do not form part of the first partial adapter 

[1718] Further partial adapters may be used in the scope of the present invention. In this case, the one or more 
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further partial adapters may cx)nvert the data between two or more intemnediate data formats. This may be advanta- 
geous In certain Instances, for example, if it is desired to have the converted data available in more than one interme- 
diate data formats. 

[1719] Continuing with the description of the steps carried out according to Fig. 13. the data now converted Into the 
5 second data format, the target data format, is further processed: 

c1 .5: writing the data In the target data format 

[1720] The printer Pr uses, for example, a XOutputStream interface to write the data in the target data format to the 
10 protocol writer PW. A XOutputStream interface In an interface for sequentially writing data to a target component: 
void XOutputStream: : writeData( pn] sequence<byte> aBuffer) 
throws lOException 

PW (Protocol Writer): writing the target data 
[1721] The protocol writer PW creates a data file from the obtained target data. Depending on the protocol used to 
15 create the target data file, a different protocol writer component PW is used. In this example, a file system writer Is 
created which iri turn creates the target file with the target data In the file system of the first computer system. 

t1.2: transferring the target data file to the file system of the first computer system 

20 [1722J The protocol writer PW creates a file in the file system of the first computer system. By using other protocol 
writer components any protocol, like HTTP or FTP, can be used to create the file, even on a third computer system 
being accessible to the first computer system. 

02: target file on first computer system 

25 

[1723] In this exemplary Implementation of the invention a target file contains the target data on the first computer 
system. 

rt: remote fransfer from first to second computer system 

30 

[1724] This Is one of the four examples given in the following for the transfer of the converted data to the target 
system: The data file 02, which is locally stored in the first computer system, is transferred (copied) to the data file 02' 
on the second computer system. 

35 D2': target file on second computer system 

[1 725] In this Implementation example of the Invention this targetfile contains the target data on the second computer 
system. 

40 rcl (remote connection 1): remote communication of protocol writer/reader 

[1726] This is another example for the transfer of the converted data to the target system: A specialized protocol 
writer PW is used on the first computer system which directly communicates with a specialized protocol reader PR2 
on the second computer system. 

45 

rc2 (remote connection 2): remote calls to XOutputStream 

[1 727] This is yet another example for the transfer of the converted data to the target system: The printer Pr on the 
first computer system uses, for example, the interface XOutputStream of the parser Pa2 on the second computer 
50 system. In this case, simple data blocks can be transmitted. The advantage may be higher efficiency due to skipping 
the steps of file writing and reading. 

rc3 (remote connection 3): remote calls to XOocumentHandler 

55 [1 728] This is the fourth example for the transfer of the converted data to the target system : The last filter of the filter 
chain A to 2 on the first computer system uses the interface XOocumentHandler of the importer component I of the 
target component to forward the data directly. The advantage may be higher efficiency due to skipping the printing and 
reparsing process steps. 
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t2.1: transferring the target data into the reader component 

[1729] Here, the target data file in the target data format can t>e accessed using direct file access on the second 
computer system. 

PR2: Protocol Reader 2 

[1730] The protocol reader PR2 on the second computer system reads the target data file created by the process 
described above from an external representation into the software system. Specialized readers for different protocols 
may exist, i.e. for FILE, HTTP or FTP 

c2. 1 : reading the target data 

[1731] The parser Pa2 reads the data of the target file from the protocol reader PR2 using the interface XInputStream 
(or similar). 

Pa2 (Parser 2): parses the target file 

[1732] The parser Pa2 parses the target data stream of the target file. For example, this can be an XML parser, 
which disassembles the target data stream into XML tokens and contents. The XInputStream offered by PR2 and 
mentioned in c2.1 is used to access the data. Alternatively, the input data could come directly from the printer Pr of 
the first computer system. In this case, Pr would provide an interface XInputStream (or similar). However, direct (un- 
buffered) polling data from remote computer systems may not be extremely efficient. 

c2.2: forwarding parsed data 

[1 733] The parser Pa2 uses a data sink interface, for example the SAX Interface XDocumentHandler. to forward the 
parsed data to the importer I of the target component TC. The main point is that this interface is generic and not 
dependent on the concrete document type. Preferably, the same interface is used as in the chain of filter components 
A to Z. 

I (Importer): builds the internal representation of the target data 

[1734] The importer of the target component TC receives the target data by an interface XDocumentHandler (or 
similar) and builds the internal representation of the target data, for example a target document. The importer I may 
be part of the target component TC. In the present example it is separated to give a clearer picture of the process. 

c2.3: building the internal representation of the target data 

[1 735] The importer I calls native functions of the target component TC to build the internal presentation of the target 
data within the target component TC. Here, unspecified interfaces, belonging to the target component TC can be used. 

TC (Target Component): for example viewer or editor 

[1736] The target component TC which is used to process the target data can be, for example, a viewer, an editor 
or any other component which processes data. The target component TC has its own set of interfaces or other methods 
of receivinig the target data. The target component TC may include the importer I. the parser Pa2 or even the protocol 
reader PR2. Preexistent software can be used on the second computer system, if the target component TC actually 
contains all of these components I, Pa2 and PR2. 

c2.4: displaying the target data 

[1737] Optionally, the target component TC may use a display component to present the document in a rendered 
(or any other) form to the user of the second computer system. 

User Terminal: 

[1 738] The user terminal can be any output device of the second computer system including, for example, the display 
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or the loudspeaker of a computer or mobile phone. 

[1 739] Alternatively to the depicted usage in two computer systems, this invention can be used on a single computer 
system too, as it is shown in Fig. 14. In this case, the target component TC and the importer component I are on the 
same computer system as is the filter chain A to Z. The components and the processes presented in Fig. 14 are identical 
with the corresponding components or processes of Fig. 13. Therefore, reference is made to the above explanations. 
[1 740] In the following, the process of building the chain of filter components A to Z is described along Fig. 1 5. 

CB: Chain Builder 

[1 741] The chain builder CB gets one or more data format types specified, for example, by a character string identifier 
like a MIME type or by a DTD identifier from the importer I of the target component TC. Herein, importer t and target 
component TC may t>e one single component. Additionally, the chain builder CB sets up a protocol reader PR to get 
the type of the original source data, specified by the same kind of identifier. Some protocols like HTTP provide a MIME 
type directly, for other protocols format detection components may be needed which read header information from the 
original source data file 01 itself. Using the list of filter components, which is available from the registry via the service 
manager SM, the chain builder CB finds the shortest possible chain of filter components which is suitable for the 
conversion of data from the first to the second data fomiat. 

FR: Filter Registry 

[1 742] The filter registry FR consists of the name of the filter component, the source data format and the target data 
fomiat specified, for example, by a MIME type or a DTD identifier, of the filter component. The entries may contain 
quality indicators (priorities). 

I: Importei- 

[1743] The importer I of the target component TC provides a list of all possible file formats, again specified, for 
example, by a MIME type or a DTD identifier. Quality indicators (priority) may be assigned to the data fomriats. 

CF: Chain Factory 

[1 744] The chain factory CF takes a descriptive representation of the filter chain, for example, a list of components 
specified by their service or implementation name. Based on this description the components are created using the 
service manager SM. The first component of the chain, the protocol reader PR, is already existent at this time. Finally, 
the chain factory CF creates the chain by connecting the newly created components together. This can be done by 
setting the SAX interface XDocumentHandlerof each successor filter component to the predecessor's filter component. 

CC: Chain Connection 

[1745] The chain connections CC are built by an interface which represents the basic structure of hierarchical doc- 
uments. The prefenred interface for these connections is the SAX interface XdocumentHandler. In the following Table 
1 the methods of the SAX interface XDocumentHandler are described: 



Table 1: 



characters 


Syntax 

Description 

Arguments 


void characters(Q string aChars); 
Receive notification of character data, 
string aChars : 


end Document 


Syntax 
Description 


void endDocumentO; 

Receive notification of the end of a document. 
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Table 1: (continued) 





endElement 


5 


Syntax 

Description 

Arguments 


void endElement(D string aName ); 
Receive notification of the end of an element, 
string aName : 




ignorableWhitespace 


10 


Syntax 

Description 

Arguments 


void ignorableWhitespace(D string aWhitespaces); 

Receive notification of ignorable whitespace in element content. 

string aWhitespaces : 


15 


processinglnstruction 


20 


Syntax 

Description 

Arguments 


void processing lnstruction(0 string aTargetQ string a Data ); 
Receive notification of a processing instruction, 
string aJarget: string aData : 




setDocumentLocator 


25 


Syntax 

Description 

Arguments 


void setDocumentLocator(Q XLocatorxLocator); 

Receive an object for locating the origin of SAX document events. 

XLocator xLocator : 




startDocument 


30 


Syntax 
Description 


void startDocumentO; 

Receive notification of the beginning of a document. 




startElement 


35 


Syntax 

Description 

Arguments 


void startElement(n string aName.Q XAttributeLlst xAttribs ); 
Receive notification of the beginning of an element . 
string aName : XAttributeLlst xAttribs: 



[1746] In Fig. 16 examples for converting documents from one data format Into another data format are shown. In 
Fig. 16a a document in the WinWord fomiat is requested in the StarWriter format. This converting may be achieved, 
for example, by employing one partial adapter for converting a WinWord document into a XML format and another 
partial adapter for converting the document in the XML format into the StarWriter format. 

[1747] For most kind of documents there is one intermediate data format established. In the example in Fig. 16b the 
RTF fomiat (Rich Text Format) is used as an intemfiediate data format to convert a text document in StarWriter forniat 
into a document in the PDF (Portable Document Format) fomriat. For the conversion of a document from the StarWriter 
format into the PDF fomnat three partial adapter may be employed. The first partial adapter may converit the StarWriter 
document into a XML format, the second partial adapter may convert the document in the XML format into the inter- 
mediate data format RTF and the third partial adapter may convert the RTF document into the PDF format. A similar 
situation is described in Fig. 16c. In this example, a XML format and the CSV (Comma Separated Value) format are 
employed as intermediate data fonnats in order to achieve proper converting from the StarBase fonmat into the EDI- 
FACT (Electronical Data Interchange) format 

[1748] In Fig. 16d it is shown that the first data format and the second data format do not need to be comparable. 
For example, if the converting of the document is requested only for viewing and not for editing the document, a con- 
version form the Excel format into the HTML format may be convenient. Such a conversion may only be possible in 
one direction. 

[1749] It will be understood that the present invention is not limited to the examples given and explained in detail. 
[1 750] In the following, further embodiments for dynamic conversion of data will be described. 
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1) A computer-based method comprising: 

receiving a request for data; 

retrieving, from a filter registry in response to said request, a rule set for a plurality of partial filter adapters 
wherein, upon being chained together said plurality of partial filter adapters converts source data to said data; 
and 

building a filter using said rule set wherein said filter comprises a chain of said plurality of partial filter adapters 
wherein each partial filter adapter includes a generic format independent interface and said generic format 
independent interface is used in passing data irom one partial filter adapter in said plurality of partial filter 
adapters to another partial filter adapter in said plurality of partial filter adapters. 

2) A method according to 1) wherein said filter renders the source data in a different way to produce said data. 

3) A method according to 1) wherein said filter converts said source data from a first format to a second format. 

4) A method according to 3) wherein a device from which said request for data was issued supports at least two 
data formats, and said method further comprises: 

selecting said second data format from said at least two data formats. 

5) A method according to 4) wherein said selecting said second data format further comprises: 

using a selection scheme including at least one of the following criterion: storage space required by said 
data in each of said two data formats supported by said process; conversion time for said data from said first data 
format into each of said data formats supported by said process; and a quality for each of said two data formats. 

6) The method of 1) further comprising converting said source data to said data using said filter 

7) The method of 1) wherein said generic format independent interface is a Simple API for XML interface. 

8) The method of 1) wherein said partial filter adapters comprise a general partial filter adapter having functionality 
determined by a parameter. 

9) The method of 8) wherein said general partial filter adapter comprises an extensible Style sheet Language 
Transfomiation processor, and said parameter comprises an extensible Style sheet Language Transformation 
script. 

10) A computer program product comprising a medium configured to store or transport computer readable code 
for a method comprising: 

receiving a request for data; 

retrieving, from a filter registry in response to said request, a rule set for a plurality of partial filter adapters 
wherein, upon being chained together said plurality of partial filter adapters converts source data to said data; 
and 

building a filter using said rule set wherein said filter comprises a chain of said plurality of partial filter adapters 
wherein each partial filter adapter includes a generic format independent interface and said generic format 
independent interface is used in passing data from one partial filter adapter in said plurality of partial filter 
adapters to another partial filter adapter in said plurality of partial filter adapters. 

11 ) A computer program product as in 1 0) wherein said filter renders the source data in a different way to produce 
said data. 

12) A computer program product as in 10) wherein said filter converts said source data ft-om a first format to a 
second format 

13) A computer-based method comprising: 
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receiving a request for data having a first format from a process requiring data in a second format; 

retrieving, from a filter registry in response to said request, a rule set for a plurality of partial filter adapters 
wherein, upon being chained together said plurality of partial filter adapters converts said data from said first 
format to said second format; and 

building a filter using said rule set wherein said filter comprises a chain of said plurality of partial filter adapters 
wherein each partial filter adapter includes a generic format independent interface and said generic format 
independent interface is used In passing data from one partial filter adapter in said plurality of partial filter 
adapters to another partial filter adapter in said plurality of partial filter adapters. 

14) A method according to 13) further comprising selecting said second data format from at least two data formats 
supported by said process. 

15) A method according to 14), wherein said selecting said second data format further comprises: 

• using a selection scheme including at least one of the following criterion: storage space required by said 
data in each of said two data formats supported by said process; conversion time for said data from said first data 
format into each of said data formats supported by said process; and a quality for each of said two data formats. 

16) The method of 13) further comprising converting said data in said first format to data in said second format 
using said filter. 

17) The method of 13) wherein said generic format independent interface is a Simple API for XML interface 

18) ThjB method of 13) wherein said partial filter adapters comprise a general partial filter adapter having function- 
ality determined by a parameter. 

19) The method of 18) wherein said general partial filter adapter comprises an extensible Style sheet Language 
Transformation processor, and said parameter comprises an extensible Style sheet Language Transformation 
script. 

20) A structure comprising: 

a partial filter adapter library; 

a partial filter adapter registry wherein said pariial filter adapter registry includes a rule set; and 

a filter server coupled to said partial filter adapter registry and to said partial filter adapter library, wherein said 
filter server uses said rule set to build a filter using a plurality of partial filter adapters from said partial filter 
adapter library. 

21) A structure comprising: 

a first partial filter adapter having a generic format independent interface; and 

a second partial filter adapter having said generic format independent interface coupled to said first partial 
filter adapter. 

22) The structure of 21) wherein said generic format independent interface is a simple API for XML interface. 

23) The stmcture of 22) wherein said simple API for XML interface is a XML document handler interface. 

24) A method for rendering accessible data stored in a first data format in a first computer system for a second 
computer system supporting a second data format, said method comprising: 

receiving in said first computer system a request from said second computer system for said data: 

receiving in said first computer system information about at least one data format supported by said second 
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computer system, 

selecting said second data format, if said first computer system was infonned about more than one data format 
supported by said second computer system; 

5 

comparing in said first computer system said first data fomiat with said second data format, 

generating a fitter for converting said data from said first data format into said second data fomriat, if said first 
data format Is Incompatible with said second data format, by combining a first partial filter adapter to a second 
10 partial adapter for the transfomiation of data; and 

converting said data in said first computer system using said filter from said first data format Into said second 
data format. 

15 25) A method for generating an adapter for converting data from a first data fomiat to a second data format, 

comprising the steps of: 

a) selecting from an adapter library a first partial adapter for converting said data from said first data format 
to an intermediate data fomiat, 

20 

b) selecting from said adapter library a second partial adapter for converting said data from said Intermediate 
data format to said second data format, and 

c) combining said first partial adapter and said second partial adapter to generate said adapter for converting 
25 said data from said first data format to said second data format. 

26] A method according to 25), wherein said adapter is generated in response to a command of a software program 
supporting said second data format to access said data being stored in said first data format. 

30 27) A method according to one of 25) or 26), comprising the further step of selecting said second data format from 

at least two data fomiats supported by said software program. 

28) A method according to one of 25) - 27), wherein said selection of said second data format is based on a 
selection scheme using at least one of the following criteria: storage space required by said data in each of said 

35 data formats supported by said software program, conversion time for said data from said first data format into 

each of said data fomnats supported by said software program, quality of said conversion. 

29) A method of using an adapter generated according to any of 25) - 28) for converting data from a first data 
fomiat into a second data format. 

40 

30) A method for rendering accessible data stored In a first data format in a first computer system to a second 
computer system supporting a second data format, comprising the steps of: 

a) receiving In said first computer system a request from said second computer system for said data, 

45 

b) receiving in said first computer system information about at least one data format supported by said second 
computer system, 

c) selecting said second data format, if In step b) said first computer system was Informed about more than 
50 one data fonnat supported by said second computer system, 

d) comparing in said first computer system said first data format with said second data format, 

e) generating an adapter for converting said data from said first data format into said second data fonnat, if 
55 said first data format Is incompatible with said second data fomfiat, by combining a first partial adapter for the 

transformation of data from said first data format to an intermediate data format and a second partial adapter 
for the transformation of data from said intermediate data format to said second data fonnat, 
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f) converting said data in said first computer system by means of said generated adapter from said first data 
fomnat into said second data fomiat, 

g) transmitting said converted data from said first computer system to said second computer system. 

31) A method for rendering accessible data stored in a first data format in a first computer system to a second 
computer system supporting a second data format, comprising the steps of: 

a) receiving in said first computer system a request from said second computer system for said data. 

b) informing said second computer system about said first data format of said requested data, 

c) selecting said second data format, if said second computer system supports more than one data format, 

d) comparing said first data format with said second data format, 

e) generating an adapter for converting said data from said first data format into said second data format, if 
said first data format is incompatible with said second data format, by combining a first partial adapter for the 
transformation of data from said first data format to an intermediate data format and a second partial adapter 
for the transformation of data from said intermediate data format to said second data format, 

f) converting said data by means of said generated adapter from said first data fomriat into said second data 
format, 

g) accessing said converted data by said second computer system. 

32) A metiiod for rendering accessible data stored in a first data fonnat in a first computer system to a second 
computer system supporting a second data format, comprising the steps of: 

a) receiving in said first computer system a request from said second computer system for said data, 

b) transmitting said requested data from said first computer system to said second computer system, 

c) so that said second computer system is able to select said second data format, if it supports more than one 
data format, 

d) wherein said second computer system is able to compare said first data format with said second data format, 

e) wherein said second computer system is able to generate an adapter for converting said data from said 
first data format into said second data format, If said first data format is incompatible with said second data 
format, by operatively connecting a first partial adapter for the transfomriation of data from said first data format 
to an intermediate data format and a second partial adapter for the transformation of data from said interme- 
diate data format to said second data format, 

f) wherein said second computer system is able to convert said data by means of said generated adapter from 
said first data format into said second data format. 

33) A method for using a second computer system supporting a second data fomriat for accessing data being 
stored in a first data format on a first computer system, comprising the following steps: 

a) requesting from said first computer system said data, 

b) informing said first computer system about at least one data format supported by said second computer 
system, 

c) so that said first computer system is able to select R^\d 5;Amnd dat» fnrmat, if it was informed about more 
than one data format supported by said second computer system. 



388 



EP 1 126 681 A2 



d) wherein said first computer system is able to compare said first data format with said second data format, 

e) wherein said first computer system is able to generate an adapter for converting said data from said first 
data format into said second data format, If said first data fomnat is incompatible with said second data format, 

5 by operatively connecting a first partial adapter for the transformation of data from said first data format to an 

intermediate data format and a second partial adapter for the transformation of data from said intermediate 
data fomnat to said second data format, 

f) wherein said first computer system is able to convert said data by means of said generated adapter from 
10 said first data format into said second data format, 

34) A method for using a second computer system supporting a second data format for accessing data being 
15 stored in a first data format on a first computer system, comprising the following steps: 

a) requesting from said first computer system said data, 

b) receiving said requested data from said first computer system in said second computer system, 

20 

c) selecting said second data format, if said second computer system supports more than one data format, 

d) comparing in said second computer system said first data fomnat with said second data format, 

25 e) generating an adapter for converting said data from said first data format into said second data fomiat, if 

said first data fonmat is incompatible with said second data format, by combining a first partial adapter for the 
transformation of data from said first data format to an intermediate data format and a second partial adapter 
for the transformation of data from said intermediate data format to said second data format, 

30 f) converting said data in said second computer system by means of said generated adapter from said first 

data format into said second data format. 

35) A method according to any of 30), 31) or 33), wherein in step b) said information about said at least one data 
format supported by said second computer system is provided indirectly by providing information about a software 

35 module on said second computer system destined to process said data. 

36) A method according to any of 30) - 35). wherein said second data format is selected according to a selection 
scheme using at least one of the following criteria: storage space required by said data in each of said data formats 
supported by said second computer system, transmission time from said first computer system to said second 

40 computer system for said data in each of said data fonnats supported by said second computer system, conversion 
time for said data from said first data format into each of said data formats supported by said second computer 
system. 

37) A method according to any of 25) - 36), wherein said intermediate data format is the fomiat of an extensible 
45 markup language (XML). 

38) A method according to any of 25) - 37), wherein at least one of said partial adapters Is bi-directional. 

39) A method according to any of 25) - 38), wherein at least one further partial adapter is used for converting said 
50 data from said Intermediate data format into a further intermediate data format, wherein said first partial adapter 

is able to convert said data from said first data format into said intermediate data fonnat and said second partial 
adapter is able to convert said data from said further intermediate data fomiat into said second data format. 

40) A computer program product for carrying out a method according to any of 25) - 39) on a computer system. 

55 

41) A data cannier for storing a computer program product for canrying out a method according to any of 25) - 39) 
on a computer system. 
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42) A method for using a computer system for carrying out a method according to any of 25) - 39). 

43) A stored data structure, comprising a set of partial adapters, wherein each partial adapter of said set of partial 
adapters is capable of converting data between a certain data fomnat and an intermediate data format. 

5 

44) A stored data structure according to 43). wherein each partial adapter being capable of converting data between 
a first data format and said intermediate data format may be combined with each other partial adapter being capable 
of converting data between a second data format and said intermediate data format in order to produce an adapter 
being capable of converting data between said first data format and said second data fomnat. 

10 

Abstract of CHAPTER E 

[1 751] A filter server receives a request for data, and in responses retrieves a mie set for a plurality of partial filter 
adapters from a filter registry. A filter is built using said rule set. The filter includes a chain of said plurality of partial 
15 filter adapters. Each partial filter adapter includes a generic forniat independent interface. The generic format inde- 
pendent interface is used in passing data from one partial filter adapter in said plurality of partial filter adapters to 
another partial filter adapter in said plurality of partial filter adapters. 

[1752] While the present invention has been explained in connection with certain embodiments thereof, other em- 
bodiments will be apparent to those skilled in the art from consideration of the specification and practice of the invention 
20 disclosed therein, it is intended that the specification and examples be considered as exemplary only, without limiting 
the spirit and scope of the invention. 



Claims 

1. A networic portal system comprising: 

a web-top manager, wherein said web-top manager is configured to receive a content request from a user 
device wherein said content request includes a content provider identifier; and 

30 

a universal content broker system coupled to said web-top manager, said universal content broker system 
comprising: 

a plurality of content providers, wherein each content provider in said plurality of content providers is 
35 associated with a different content provider identifier, and each content provider accesses content having 

a different raw data fomnat; 

a universal content broker coupled to said web-top manager and to said plurality of content providers 
wherein upon said receipt of said content request from said web-top manager, said universal content 
40 broker passes said request to a content provider in said plurality of content providers that is associated 

with said content provider identifier. 

2. The system of Claim 1 wherein said web-top manager further comprises a plurality of remote applications. 
45 3. The system of Claim 1 wherein said web-top manager further comprises: 

a web server; 

a main sennet executing on said web server, wherein said main servlet receives a user device content request; 
50 and 

a presentation and logic system coupled to said main servlet, and configured to receive raw data content in 
a plurality of different raw data formats from said universal content broker system, wherein said presentation 
and logic system converts raw data content in'espective of said raw data fomnat, based upon characteristics 
55 of said user device, into a page displayable on said user device. 

4. The system of Claim 3 wherein said presentation and logic system includes a plurality of templates. 
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5. The system of Claim 4 wherein said plurality of templates includes at least one of; 

a first set of template sets wherein said first set of template sets is for a first type of user device page fomiat; and 

a second set of template sets wherein said second set of template sets is for a second type of user device 
page format. 

6. The system of Claim 5 wherein said first and/or second set of template sets Includes a set of content format 
template sets wherein each content format template set is for a different one of said plurality of different raw data 
fomiats. 

7. Tiic bybieni ui Cldiin u w'ncioiti ^'lu bei u) uuiiieiu iurrndi lempidiub cornprist; a bei ot duviue capdDiniy specifiu 
templates. 

8. The system of Claim 3 wherein said presentation and logic system comprises a plurality of provider objects wherein 
each provider object is associated with a different content provider identifier. 

9. The system of Claim 8 wherein said presentation and logic system comprises a plurality of adapter objects coupled 
to said plurality of provider objects wherein each adapter object is associated with a different content provider 
identifier, and further wherein said adapter object receives content from said content provider associated with said 
different content provider identifier and provides said content to the provider object associated with said different 
content provider identifier. 

1 0. The system of Claim 3 wherein said presentation and logic system comprises a plurality of adapter objects wherein 
each adapter object is associated with a different content provider identifier, and further wherein said adapter object 
receives content from said content provider associated with said different content provider identifier and provides 
said content to a provider object associated with said different content provider identifier 

11. The system of Claim 3 wherein said presentation and logic system comprises: 

a profiling service. 

12. The system of Claim 11 wherein said presentation and logic system comprises: 

a profiling service configuration file coupled to said profiling service. 

13. The system of Claim 12 wherein said profiling sen/ice configuration file includes a decision tree wherein said 
decision tree performs actions. 

U. The system of Claim 13 wherein said decision tree is a XML decision tree. 

15. The system of Claim 13 wherein said actions include at least one of: 

an action based upon request parameters; 
an action based upon request header parameters; 
an action based upon user device properties; and 
an action based upon resource properties. 

1 6. The system of Claim 11 or 1 3 wherein said presentation and logic system comprises a plurality of screen templates. 

17. The system of Claim 16 wherein one screen template in said plurality of screen templates is one of: 

a default screen template for a HTML page; 

a default screen template for a mobile telephone; and 

a default screen template for a personal digital assistant. 
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18. The system of Claim 17 wherein one saeen template in a plurality of said screen templates comprises a default 
screen template. 

19. The system of Claim 18 wherein said default screen template Includes a header region having at least one place 
5 holder and a body region having at least one place holder. 

20. The system of Claim 19 wherein said action of said decision tree determines a component that is used for said at 
least one placeholder in said body region. 

10 21. The system of Claim 20 wherein said component provides infonnation that Is taken from said raw data content. 

I lie ayaiciii ui Cidiiii i wiiciciii miu uiiiveibtii uunicuL uiukci bybieiii luiuici vAJiii^iiae^. 

a registry of content providers coupled to said universal content broker wherein said universal content broker 
selects said content provider from said registry based upon said content provider identifier 

15 

23. The system of Claim 1 , wherein said universal content broker system includes at least one of: 
at least one interface adapted to associate property values with content; 
20 at least one interface adapted to set a property value of content; 

at least one interface adapted to read a property value of content; 

an interface adapted to notify registered client systems when content of interest to said registered client sys- 
25 iems is processed by said universal content broker system; and 

an interface adapted to notify registered client systems when new content is created by said universal content 
broker system. 

30 24. The system of Claim 1 wherein said universal content broker system further comprises a hierarchy content provider 

25. The system of Claim 24 wherein said hierarchy content provider generates a virtual hierarchy of content of said 
universal content broker system. 

35 26. The system of Claim 1 wherein said universal content broker system further comprises a configuration sender 

27. The system of Claim 26 further comprising a configuration proxy coupled to said configuration server 

28. The system of Claim 27 wherein said configuration server further comprises a first DOM tree. 

40 

29. The system of Claim 28 wherein said DOM tree includes user profiles and/or application profiles. 

30. The system of Claim 27 wherein said configuration proxy further comprises a second DOM tree wherein said 
second DOM tree includes a subset of data in said first DOM tree. 

45 

31. The system of Claim 1 further comprising a client system coupled to said network portal system. 

32. The system of Claim 31 wherein said client system includes a client universal content broker system. 

50 33. The system of Claim 32 wherein said client universal content broker system includes a synchronization component 
for synchronizing content of said client universal content broker system with content of said universal content 
broker system. 

34. A network portal system comprising: 

55 

a web-top manager, wherein said web-top manager is configured to receive a content request from a user 
device wherein said content request includes an identifier for content having a raw data format wherein said 
web-top manager further comprises: 
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a web server; 

a main servlet executing on said web server, wherein said main servlet receives a user device content 
request; and 

a presentation and logic system coupled to said main servlet, and configured to receive raw data content 
in a plurality of different raw data formats from said universal content broker system, wherein said pres- 
entation and logic system converts raw data content laespective of said raw data format, based upon 
characteristics of said user device, Into a page displayable on said user device; and 

a universal content broker system coupled to said web-top manager, said universal content broker system 
compnsing: 

a plurality of content providers, wherein each content provider in said plurality of content providers is 
associated with a different content provider identifier, and each content provider accesses content having 
a different raw data fomiat; 

a hierarchy content provider; and 

a universal content broker coupled to said web-top manager and to said plurality of content providers 
wherein upon said receipt of said content request from said web-top manager, said universal content 
broker passes said request to a content provider In said plurality of content providers that is associated 
with said content provider Identifier. 

35. The system of Claim 34 wherein said universal content broker system further comprises a configuration sender 

36. The system of Claim 34 wherein said web-top manager further comprises: 

a plurality of portlets; and 

a presentation manager coupled to said plurality of portlets upon receipt of said user request, said presentation 
manager send said user request to one of said plurality of portlets. 

37. A system comprising: 

a web server, 

a main servlet executing on said web server, wherein said main servlet receives a user device content request; 
and 

a presentation and logic system coupled to said main servlet, and configured to receive raw data content in 
a plurality of different raw data fonnats, wherein said presentation and logic system converts raw data content 
irrespective of said raw data fomnat. based upon characteristics of said user device, Into a page displayable 
on said user device. 

38. The system of Claim 37 wherein said presentation and logic system Includes a pluraljty of templates. 

39. The system of Claim 38 wherein said plurality of templates includes at least one of: 

a first set of template sets wherein said first set of template sets Is for a first type of user device page format; and 

a second set of template sets wherein said second set of template sets is for a second type of user device 
page format. 

40. The system of Claim 39 wherein said first and/or second set of template sets includes a set of content format 
template sets wherein each content format template set is for a different one nf said plur^ility nf riiffprpnt r»w data 
fomiats. 
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41. The system of Qaim 40 wherein said set of content format templates comprise a set of device capability specific 
templates. 

42. The system of Claim 37 wherein said presentation and logic system comprises a plurality of provider objects 
wherein each provider object is associated with a different content provider identifier. 

43. The system of Claim 42 wherein said presentation and logic system comprises a plurality of adapter objects coupled 
to said plurality of provider objects wherein each adapter object is associated with a different content provider 
identifier, and further wherein said adapter object receives content associated with said different content provider 
identifier and provides said content to the provider object associated with said different content provider identifier. 

•rt. 1 1 ic oy Old 1 1 ui oicaii moi wi ici eii i aaiu \n caei luauui i ai lu luyiu dyaici ii iaji i i^ica a piur dii ly ui dudpim uujecib wnt;r eii i 

each adapter object is associated with a different content provider Identifier, and further wherein said adapter object 
receives content associated with said different content provider identifier and provides said content to a provider 
object associated with said different content provider identifier. 

45. The system of Claim 37 wherein said presentation and logic system comprises: 

a profiling service. 

46. The system of Claim 45 wherein said presentation and logic system comprises: 

a profiling service configuration file coupled to said profiling service. 

47. The system of Claim 46 wherein said profiling sen/ice configuration file Includes a decision tree wherein said 
decision tree performs actions. 

48. The system of Claim 47 wherein said decision tree is a XML decision tree. 

49. The system of Claim 47 wherein said actions include at least one of: 

an action based upon request parameters; 
an action based upon request header parameters; 
an action based upon user device properties; and 
an action based upon resource properties. 

50. The system of Claim 49 wherein one screen template in said plurality of screen templates is one of: 

a default screen template for a HTML page; 

a default screen template for a mobile telephone; and 

a default screen template for a personal device assistant. 

51 . The system of Claim 45 or 47 wherein said presentation and logic system comprises a plurality of screen templates. 

52. The system of Claim 51 wherein.one screen template In a plurality of said screen templates comprises a default 
screen template. 

53. The system of Claim 52 wherein said default screen template includes a header region having at least one place 
holder and a body region having at least one place holder. 

54. The system of Claim 53 wherein said action of said decision tree determines a component that is used for said at 
least one placeholder In said body region. 

55. The system of Claim 54 wherein said component provides information that is taken from said raw data content. 
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56. A system comprising: 

a plurality of content providers, wherein each content provider in said plurality of content providers is associated 
with a different content provider identifier, and each content provider accesses content having a different raw 
5 data format; 

a universal content broker coupled to said plurality of content providers wherein upon said receipt of a content 
request including a content provider identifier, said universal content broker passes said request to a content 
provider in said plurality of content providers that is associated with said content provider identifier. 

10 

57. The system of Claim 56 further comprising: 

u . wg.iMu J wi WW! iw. tt. ^1 w wfwupiow Aciiwt Ml Hvci odi uo IV Ml ufvci m icicii I aaiVJ Ul tivei oai UUI IICI U UIUI^BI 

selects said content provider from said registry based upon said content provider identifier 

^ 5 58. The system of Claim 56 further comprising at least one interface adapted to associate property values with content. 

59. The system of Claim 56, further comprising at least one interface adapted to set and/or read a property value of 
content. 

20 60. The system of Claim 56, further comprising an interface adapted to notify registered client systems when content 
of interest to said registered client systems is created and/or processed by said universal content broker system. 

61. The system of Claim 56 further comprising a hierarchy content provider 

25 62. The system of Claim 61 wherein said hierarchy content provider generates a virtual hierarchy of content of said 
universal content broker system. 

63. The system of Claim 56 further comprising a configuration server 

30 64. The system of Claim 63 further comprising a configuration proxy coupled to said configuration server 

65. The system of Claim 64 wherein said configuration server further comprises a first DOM tree. 

66. The system of Claim 65 wherein said DOM tree includes user profiles and/or application profiles. 

35 

67. The system of Claim 64 wherein said configuration proxy further comprises a second DOM tree wherein said 
second DOM tree includes a subset of data in said first DOM tree. 

68. A computer program product comprising computer program code for a universal content provider service compris- 
40 ing: 

a component interface; and 
a content provider interface. 

45 

69. A computer program product of Claim 68 further comprising: 

a content identifier factory interface. 

70. A computer program product comprising computer program code for a universal content broker service comprising: 

50 

a component interface; and 

a content provider manager interface. 

55 71 . The computer program product of Claim 70 further comprising: 
a content provider intRrfacA. 

72. A computer program product of Claim 70 further comprising: 
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a content identifier factory interface. 

73. A computer program product comprising computer program code for a configuration and logic sendee comprising: 

a profiling service; and 

a plurality of screen templates. 

74. The computer program product of Claim 73 furtlier comprising a decision tree. 

75. A method for providing a plurality of content having different types and different protocols to a single user interface 

receiving a content request from a client system wherein said content request comprises a content Identifier 

selecting a content provider associated with said content identifier from a plurality of content providers wherein 
each of said content providers provides access to content having a different raw data format; 

retrieving said requested content from said selected content provider; and 

using said requested content to generate a page displayable on said client system. 

76. The method of Claim 75 wherein said selecting a content provider comprises: 

searching a registry including said plurality of content providers. 

77. A network portal system, which serves for linking, via a communication network (2303), a plurality of provider 
systems (2301 A, 2301 B) with a plurality of client systems (2302A, 2302B), each said provider system (2301 A, 
23018) offering content according to a predetermined communication scheme of a plurality of different communi- 
cation schemes, said content being information which is transmittable over said network (2303), each said client 
system (2302A. 2302B) supporting a predetermined communication scheme of said plurality of different commu- 
nication schemes, said network portal system comprising: 

a) webtop means (2411) for receiving a content request from a client system (2302A. 23028), said request 
comprising a content indicator being indicative of the content, and an indicator of the requesting client system 
(2302A, 23028). said client system indicator specifying the communication scheme supported by said client 
system (2302A, 2302B), 

b) universal content broker means (2413) for selecting a provider system {2301A, 2301B) which is able to 
provide said requested content, 

c) for accessing said selected provider system (2301 A, 2301 B), and 

d) for retrieving said requested content from said accessed provider system (2301 A, 23018), 

e) said webtop means (2411) being further adapted for rendering the retrieved content to said requesting client 
system (2302A, 2302B) according to the communication scheme of said requesting client system (2302A. 
23028). . . 

78. The system according to claim 77, whereby said universal content broker means (2413) are further adapted for 
selecting said provider system (2301A, 2301B) by searching a register (2415) comprising accessible provider 
systems (2301 A, 23018). 

79. The system according to claim 78, whereby said universal content broker means (2413) are further adapted for 
maintaining said register (2415). 

80. The system according to the preceding claim, whereby said universal content broker means (2413) are further 
adapted for transmitting content to provider systems (2302A. 23028). 
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81. The system according to one of the claims 77-80, further comprising application program means (2414A, 2414B, 
2414C) for rendering application program services to client systems (2302A, 2302B). 

82. The system according to one of the claims 77-81, whereby said universal content broker means (2413) have 
access to local storage means (2416) for storing content therein. 

83. The system according to one of the claims 77-82, whereby said universal content broker means (24 1 3) are adapted 
for associating property values to content and storing said property values in storage means (2417). 

84. The system according to the preceding claim, whereby said universal content broker riieans (2413) are further 
adapted^for settjng, and/ o^ reading said property values^ _ _ 



85. The system according to the preceding claim, whereby said property values are used to render client specific 
representation~of content. " 

88. The system according to one of the claims 77-85, said universal content broker means (2413) are further adapted 
for notifying predetermined client systems when predetermined content is created and/or processed by said uni- 
versal content broker means (24 13). 

87. The system according to one of the claims 77-86, further comprising means (2418A, 241 8B, 2418C) for converting 
content compliant with a predetermined communication scheme into content compliant with another communica- 
tion scheme. 

88. The system according to one of the claims 77-87, wherein said webtop means (2411) are further adapted for 
rendering content over a secure networi^ channel to a client system (2302A, 2302B). 

89. The system according to one of the claims 77-88, wherein said webtop means (241 1 ) are further adapted to render 
content to an individual client system (2302A, 2302B) according to predetermined individual access rights. 

90. The system according to one of the claims 77-89. wherein said webtop means (2411) have access to a plurality 
of templates, each said template defining the structure of said requested content according to a particular client 
system (2302A, 2302B). 

91. The system according to one of the claims 77-90, wherein said webtop means (2411) are further adapted for 
rendering content according to predetermined stylesheets, each said stylesheet defining visual presentation of 
said requested content. 

92. The system according to one of the claims 77-91 , wherein said content is of the type of: file systems, databases, 
mails, news, mail messages, news messages. 

93. The system according to one of the claims 77-92, wherein said content can be hierarchically ordered according 
to a parent-, peer-, child-relationship, respectively. 

94. The system according to one of the claims 77-93, wherein said content is associated with predetemiined tasks, 
whereby each task is indicative of content properties or commands admitted to operate on said content. 

95. The system according to one of the claims 77-94, further comprising a networic sender (2312) for connecting to 
said network (2303). 

96. A method for linking, via a communication network (2303), a plurality of provider systems (2301 A, 2301 B) with a 
plurality of client systems (2302A, 2302B), each said provider system (2301A. 2301B) offering content according 
to a predetermined communication scheme of a plurality of different communication schemes, said content being 
information which is transmittable over said networtc (2303), each said client system (2302A, 2302B) supporting 
a predetermined communication scheme of said plurality of different communication schemes, said method com- 
prising the following steps: 

a) receiving (281 0) a content request from a client system (2302A. 2302B), said request comprising a content 
indicator being indicative of the content, and an indicator of the requesting client system (2302A, 2302B), said 
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client system indicator specifying the communication scheme supported by said client system (2302A, 23026), 
b) selecting (2820) a provider system (2301 A, 2301 B) which is able to provide said requested content. 
5 c) accessing (2830) said selected provider system (2301A, 23018), 

d) retrieving (2840) said requested content from said accessed provider system (2301 A, 2301 B). 

e) rendering (2850) the retrieved content to said requesting client system (2302A, 2302B) according to the 
10 communication scheme of said requesting client system (2302A, 2302B). 



}Sf. me memoa accoraing lo ine prececing aarm, wnereoy saia pioviuei bybtem \£.**\o) it> stjieuieu uy &cdiumiy a 
register comprising accessible pn^vider systems (2301 A, 2301 B). 

15 98. The method according to the preceding claim, further comprising a step of transmitting content to provider systems 
(2302A, 2302B). 

99. The method according to one of the claims 96-98, further comprising rendering application program services to 
client systems (2302A, 2302B). 

20 

100. The method according to one of the claims 96-99, further comprising accessing to local storage means for storing 
content therein. 

101 .The method according to one of the claims 96-100, further comprising associating property values to content and 
25 storing said property values. 

102.The method according to the preceding method daim, further comprising setting, and/ or reading said property 
values, 

30 l03.The method according to the preceding method claim, whereby said property values are used to render client 
specific representation of content. 

104. The method according to one of the claims 96-103, further comprising notifying predetemnined client systems 
(2302A, 2302B) when predetemiined content is created and/or processed. 

35 

105. The method according to one of the claims 96-104, whereby content compliant with a predetermined communi- 
cation scheme is converted into content compliant with another communication scheme. 

106. The method according to one of the claims 96-105, whereby content is rendered over a secure networic channel 
40 to a client system (2302A, 2302B). 

107. The method acconJing to one of the claims 96-106, whereby content is rendered to an individual client system 
(2302A, 2302B) according to predetermined individual access rights. 

45 1 0S.The method according to one of the claims 96-1 07 , whereby a plurality of templates is accessed, each said template 
defining the stoicture of said requested content according to a particular client system (2302A, 23028). 

109. The method according to one of the claims 96-108, whereby content is rendered according to predetermined 
stylesheets, each said stylesheet defining visual presentation of said requested content. 

50 

1 1 0. The method according to one of the claims 96-1 09, whereby said content is of the type of: file systems, databases, 
mails, news, mail messages, news messages. 

1 1 1 .The method according to one of the claims 96-11 0, whereby said content can be hierarchically ordered according 
55 to a parent-, peer-, child-relationship, respectively 

1 12.The method according to one of the claims 96-111 . whereby said content is associated with predetermined tasks, 
whereby each task is indicative of content properties or commands admitted to operate on said content. 
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113, The method according to one of the claims 96-112. whereby an hierarchical view of content can be produced, 
which view may be different to the physical structure on the content. 

114. A computer program for performing the method according to one of the daims 96-113. 

1 1 S.Data carrier means containing computer software for performing the method according to one of the claims 96- 11 3. 
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<%-- Default html-template -%> Chapter a 

<%@ laglib uri="AVEB-INF/coiifig/taglib.tld" prefix="starportal" %> 
<%@ page import - "coni.sun.star.portal.web.servlets.MainServlet" %> 
<%@ page import = "com.sim.star.portal.web.beans.ErrorBean" %> 
<%@ page import = "com.sun.star.portal.web.beans.LoginBean" %> 
<html> 
<head> 

<title> 

<starportal:insert componentName-Title"/> 
</titIe> 

<meta name="description" content="StarPortal "> 
<meta name="keywords" content-' starportal, starofiice, software"> 
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-r'> 
</head> 

<body leftmargin="0" topmargin="0" marginwidth="0" marginheight="0" 
background="<%=request.getContextPath()%>ypics/fillgrey.gif> 



<tr> 

<td width="%" height="18"> 

<starportal:insert componentName="Shortcuts'7> 
</td> 

<table width="100%" border="0" cellspacing="0" cellpadding="0"> 
<tr> 

<tdwidth=lOx/td> 
<td> 

<pxstarportal:insert componentName="CurrentFolder"/x/p> 
<pXstarportal:insert componentName="FolderView'7x7p> 
<pXstarportal :insert component>Jame="FileView"/x/p> 

</td> 
</tr> 

<tr><td height=10x/tdx/tr> 
</table> 
<% 

} 

else 

{ 



%> 
<% 



<pxstarporta!: insert componentName="Error'Vx/p> 
request.removeAttribute(MainServlet.ERROR); 



1 100 



%> 
</body> 
</html> 



Fig. 11 
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struct uno_Erivironmeat 

^ Chapter B 

/** a name for this environment 
*/ 

rtl_Slring * pName; 

/♦* A free context pointer, that can be used for specific classes of environments, e.g. 
a jvm pointer 

*/ 

vuiu • puoiJicAt; 
/** Acquires this environment. 

@param pEnv this interface 

*/ 

void (SAL_CALL * acquire)( ano_Environment * pEnv ); 
/** Releases this environment; Last release of environment revokes the environment 
from runtime. 

@param p Access this access interface 

♦/ 

void (SAL_CALL * release)( uno_Environment * pEnv ); 
/** Tests if two environments are equal. 

@parampEnvl one environment 
@param pEnv2 another envirormient 

*/ 

sal_Boo] (SAL CALL * equals) ( const uno Environment* pEnvl, const 
uno_Environment * pEnv2 ); 

* You register internal and external interfaces via his method. Internal interfaces are 
proxies that are used in an environment. External interfaces are interfaces 
that are exported to another environment, thus providing an object identifier 
for this task. This can be called an external reference. Interfaces are held 
weakly at an enviroimient; they demand a final revokelnterfaceOcall for each 
interface that has been registered. 

@param pEnv this environment 

@param pplnterface inout parameter for the registered interface 
@pardm ppOId inout parameter for the corresponding object id 
@param pTypeDescr type description of interface 
@param acquire fimction to acquire an interface; this function 

provides a boolean return value to signal if the acquisition was 
successful (necessary for proxy interfaces) 

*/ 

void (S AL^CALL * registerlnterface) (uno^Environment * pEnv, void ** 
pplnterface, rtl_String ** ppOId, typelib_lnterfaceTypeDescription 
*pTypeDescr, uno_regAcquireFunc acquire ); 

/** 

ANY interface that has been registered is revokeed via this method. 
@param pEnv this environment 
@param pOId object id of interface to be revoked 
@param pTypeDescr type description of interface to be revoked 

♦/ 

void (SAL^CALL * revokelnterface) ( uno_Environment * pEnv, rtl_String * 
pOId, typelib InterfaccTypeDescription * pTypeDescr ); 

Fig. 3A 
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/** Retrieves an interface identified by its object id and type from this environment. 
@parani pEnv this environment 

@param pplnterface inout parameter for the registered interface; (0) if 
none was found 

tparam pOId object id of interface to be retrieved 
param pTypeDescr type description of interface to be retrieved 

'/ 

void (SAL_CALL * getRegisteredlnterface) ( uno__Environment * pEnv, void 
** pplnterface, rtl_String * pOld, typelibJnterfaceTypeDescription * 
pTypcDcscr ); 

/♦* 

Retrieves the object identifier for a registered interface from this environment. 
@param pEnv this environment 

@param ppOId inout parameter for object id of interface; (0) if none 
was found 
aram pinterface a registered interface 
aram pTypeDescr type description of interface 
*/ 

void (S AL_CALL * getRegisteredObjectldentifier) ( uno^Environment * 
pEnv, rtl_String *♦ ppOId, void * 
plnterface,typclib_IntcrfaceTypeDescription * pTypeDescr ); 

/** 

* Disposing callback fimction pointer that can be set to get signalled before the 

environment is destroyed. 

@param pEnv environment that is being disposed 

♦/ 

void (SAL^CALL * environmentDisposing) ( uno_Environment * pEnv ); 

* Computes an object identifier for the given interface; is called by the environment 

implementation. 

@param pEnv corresponding environment 
@param ppOId out param: computed id 
@param pinterface an interface 

*/ 

void (SAL_CALL * computeObjectldentifier) ( uno^Environment * pEnv, 
rtl_String ** ppOId, void * pinterface ); 
/** Function to acquire an interface. 

@param pEnv corresponding environment 
@param pinterface an interface 

*/ 

void (SAL_CALL * acquirelnterface) ( uno_Environment * pEnv, void * 
pinterface ); 

* Function to release an interface. 

@param pEnv corresponding environment 
@param pinterface an interface 

*/ 

void (SAL_CALL * releaselnterface) ( uno_Environment * pEnv, void * pinterface 

); 

Fig. 3B 
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